Skip to main content

PnL Watchdog for Crypto Market Makers

PnL Watchdog is a read-only execution intelligence layer for market makers on crypto venues like Bybit.

It helps you answer one question fast: is my edge being eaten by microstructure friction?

Why it is useful

  • Measures execution friction (impact, slippage, toxicity proxies, order-flow quality)
  • Flags anomaly windows where fills degrade (latency/slippage outliers)
  • Gives user-scoped import + analytics from your own account history
  • Works with read-only exchange credentials (no trade/withdraw permissions required)

5-minute setup

  1. Start API:
uvicorn pnl_watchdog_lib.api.main:app --host 0.0.0.0 --port 8000
  1. Register your PnL Watchdog API key:
curl -X POST http://localhost:8000/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'
  1. Import Bybit read-only trade history:
curl -X POST http://localhost:8000/import/bybit \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pnlw_your_key" \
  -d '{"api_key":"BYBIT_READ_KEY","api_secret":"BYBIT_READ_SECRET","market_type":"swap","lookback_days":7}'
  1. Get your execution stats:
curl -X GET http://localhost:8000/stats/pnl \
  -H "X-API-Key: pnlw_your_key"

Security model

  • Use exchange keys with read-only scope only.
  • PnL Watchdog API keys are stored hashed at rest.
  • Data is scoped per authenticated user.

Metadata

Release files for pnl-core 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for pnl-core 0.7.1
File Interpreter ABI Platform
pnl_core-0.7.1-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details

Release files / pnl_core-0.7.1-cp310-cp310-macosx_11_0_arm64.whl

Download URL pnl_core-0.7.1-cp310-cp310-macosx_11_0_arm64.whl
Size 268.5 kB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
f812611f1e37b4661d46e839a78cf60dec6ae60090193cfb211b3f64a2e899ed
BLAKE2b-256 checksum
How to use checksums
b70c9c335acd4846dff18d60b731a5fd402b8929306251e9346a99336df67a2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.0

Release history Release notifications | RSS feed

This release

0.7.1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page