Everything you need to integrate Depthy into your trading bot, dashboard, or AI agent. Liquidation clusters, depth history, OI deltas, cascade inference, and Polymarket smart-money data.
Up and running in 60 seconds. Three steps from zero to live order book data.
Sign up on the pricing page to get a free API key instantly, or call the signup endpoint directly:
curl -X POST https://depthy.io/v1/auth/register \ -H "Content-Type: application/json" \ -d '{"email": "you@example.com"}'
Fetch the current BTC-PERP order book from Hyperliquid with a single curl command:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://depthy.io/v1/depth/hyperliquid/BTC-PERPDrop this into your bot and start reading depth metrics:
import requests
resp = requests.get(
"https://depthy.io/v1/depth/hyperliquid/BTC-PERP",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
book = resp.json()
print(f"Mid: {book['metrics']['mid_price']}, Spread: {book['metrics']['spread_bps']}bps")All endpoints except /v1/health require a valid API key in the Authorization header.
Authorization: Bearer dk_live_abc123...
All tiers accept crypto payments via NOWPayments (200+ cryptocurrencies). Use POST /v1/payments/create-invoice to generate a payment link. Pro and Enterprise plans activate automatically on payment confirmation.
Limits are enforced per API key. Standard and heavy endpoints have separate pools.
| Tier | Standard endpoints | Heavy endpoints (heatmaps) | On exceed |
|---|---|---|---|
| Free | 30 req/min | — | 429 for 60 seconds |
| Metered | 60 req/min | 10 req/min | 429 for 60 seconds |
| Pro | 120 req/min | 10 req/min | 429 for 60 seconds |
| Enterprise | 300 req/min | 30 req/min | 429 for 60 seconds |
Every response includes these headers so your client can self-throttle:
X-RateLimit-Limit — Maximum requests per windowX-RateLimit-Remaining — Requests remaining in current windowX-RateLimit-Reset — Unix timestamp when the window resetsChoose the plan that fits your trading operation. Upgrade or downgrade at any time.
| Feature | Free ($0/mo) | Metered (pay-per-query) | Pro ($99/mo) | Enterprise ($499/mo) |
|---|---|---|---|---|
| Rate limit | 30/min | 60/min | 120/min | 300/min |
| HL symbols | Top 10 | All 228 | All 228 | All 228 |
| Depth / Walls / Market | Yes (T1 only) | Yes (all) | Yes (all) | Yes (all) |
| Heatmaps | — | Yes | Yes | Yes |
| Compare | — | Yes | Yes | Yes |
| PM Adjustment Latency | — | Yes | Yes | Yes |
| PM Series Recent | — | Yes | Yes | Yes |
| Historical archive | — | — | — | Yes |
All endpoints grouped by domain. Params in {braces} are path parameters. Click any endpoint to expand details.
Returns the current order book snapshot with computed depth metrics: mid price, spread, imbalance ratio, and depth at various price levels.
| Name | Type | Description |
|---|---|---|
| exchange | string | Exchange name (e.g. hyperliquid) |
| symbol | string | Trading pair (e.g. BTC-PERP) |
curl -H "Authorization: Bearer YOUR_KEY" \ https://depthy.io/v1/depth/hyperliquid/BTC-PERP
Returns depth metrics over the last 6 hours for charting and trend analysis.
Detects large persistent orders ($100K+) that act as support/resistance walls in the order book.
Returns current market data: mark price, funding rate, open interest, and 24h volume.
Returns estimated liquidation clusters at 14 price zones above and below current price.
Compare depth metrics across multiple symbols in a single request. Pass comma-separated symbols.
Returns a time x price grid of order book depth snapshots for heatmap visualization.
Returns actual liquidation trades plotted on a time x price grid.
Returns estimated liquidation zone intensities on a time x price grid.
Returns active Polymarket markets with prices, volumes, and depth metrics.
Returns detailed data for a single Polymarket market by its condition ID.
Returns all tracked Polymarket series with aggregate depth and volume statistics.
Returns recent depth timeseries data for a specific Polymarket series.
Measures how fast Polymarket crypto markets reprice after Binance moves. Broken down by hour and day of week.
Returns all 6 paper trading strategy portfolios sorted by balance. Each strategy starts with $10,000 and trades automatically based on Depthy signals. No authentication required.
curl https://depthy.io/v1/paper/portfolios
{
"portfolios": [
{
"strategy": "consensus",
"starting_balance": 10000.0,
"current_balance": 10250.50,
"total_trades": 12,
"open_trades": 3,
"wins": 6,
"losses": 3,
"total_pnl": 250.50,
"win_rate": 0.6667,
"return_pct": 2.51,
"last_updated": "2026-02-21T14:30:00"
}
]
}
Returns recent paper trades, optionally filtered by strategy and status. No authentication required.
| Name | Type | Description |
|---|---|---|
| strategy | string optional | Filter by strategy name (e.g. consensus, whale_reversal) |
| status | string optional | Filter by trade status: open or closed |
| limit | integer optional | 1-500, default 50 |
curl "https://depthy.io/v1/paper/trades?strategy=consensus&status=open&limit=10"
{
"trades": [
{
"trade_id": "pt_abc123",
"strategy": "consensus",
"signal_id": "sig_...",
"signal_type": "SMART_MONEY",
"market_id": "0x4c96...",
"market_title": "Will Trump win 2028?",
"side": "YES",
"entry_price": 0.65,
"exit_price": null,
"size_usd": 500.0,
"pnl": null,
"status": "open",
"opened_at": "2026-02-21T12:00:00",
"closed_at": null
}
],
"count": 1
}
Full detail for a single paper trade including the originating signal, wallet profile, current market price, and Polymarket link. No authentication required.
| Name | Type | Description |
|---|---|---|
| trade_id | string required | Paper trade ID (path param) |
curl https://depthy.io/v1/paper/trade/pt_abc123
{
"trade_id": "pt_abc123",
"strategy": "consensus",
"signal_id": "sig_...",
"signal_type": "SMART_MONEY",
"market_id": "0x4c96...",
"market_title": "Will Trump win 2028?",
"side": "YES",
"entry_price": 0.65,
"exit_price": null,
"size_usd": 500.0,
"pnl": null,
"status": "open",
"opened_at": "2026-02-21T12:00:00",
"closed_at": null,
"signal_severity": 72.5,
"signal_title": "Smart money BUY Yes $500...",
"signal_metadata": {"side": "BUY", "outcome": "Yes"},
"signal_wallet": "0xd218...",
"wallet_info": {
"wallet": "0xd218...",
"score": 82.3,
"total_pnl_usd": 1250.50,
"win_rate": 0.74,
"total_trades": 47
},
"current_yes_price": 0.68,
"market_slug": "will-trump-win-2028"
}
Daily equity curve per strategy (cumulative balance from closed trades) plus signal accuracy breakdown by signal type. No authentication required.
curl https://depthy.io/v1/paper/performance
{
"equity_curves": {
"consensus": [
{"date": "2026-02-20", "balance": 10000.0},
{"date": "2026-02-21", "balance": 10125.50, "daily_pnl": 125.50}
]
},
"signal_accuracy": [
{
"signal_type": "SMART_MONEY",
"total_trades": 15,
"wins": 10,
"losses": 5,
"win_rate": 0.6667,
"avg_pnl": 18.50,
"total_pnl": 277.50
}
]
}
Returns system health status including collector uptime, Redis connection, and staging stats. No authentication required.
Returns detailed system status. Requires master API key.
Returns all tracked Hyperliquid symbols grouped by collection tier (T1, T2, T3).
Creates a NOWPayments invoice for upgrading your tier. Supports 200+ cryptocurrencies.
Returns the current status of a payment by its ID.
Returns your complete payment history with amounts and statuses.
The temporal arbitrage edge. Understand exactly how fast Polymarket crypto markets reprice after Binance moves.
When BTC moves more than 0.1% on Binance Futures within a 30-second window, we start a clock. The moment a Polymarket crypto book shifts by more than 2 cents, the clock stops. That interval is the adjustment latency — the time it takes Polymarket market makers to reprice.
If a series consistently reprices in 3 seconds during trading hours but 12 seconds on Sunday nights, your bot can set asymmetric timeout windows. Wider windows on slow periods mean more fill opportunities. Tighter windows on fast periods avoid adverse selection.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://depthy.io/v1/polymarket/adjustment-latency/BTC-DAILY-UP{
"series": "BTC-DAILY-UP",
"overall": {
"avg_ms": 3240,
"median_ms": 2810,
"p95_ms": 8450,
"sample_count": 1847
},
"by_hour": {
"14": { "avg_ms": 2100, "median_ms": 1850, "p95_ms": 4200, "sample_count": 142 },
"03": { "avg_ms": 8100, "median_ms": 7200, "p95_ms": 15600, "sample_count": 34 }
},
"by_day_of_week": {
"Monday": { "avg_ms": 2900, "sample_count": 310 },
"Sunday": { "avg_ms": 6400, "sample_count": 89 }
}
}If BTC-15M-UP reprices in 3.2s on weekday afternoons but 8.1s on Sunday nights, you can set your bot's timeout window accordingly. During fast periods, use tight fills and aggressive quoting. During slow periods, widen your spread and extend your fill timeout to capture the latency premium.
For the full OpenAPI spec with request/response schemas, try our interactive documentation. Both include all endpoints, parameters, and example payloads.
Get your free API key in 30 seconds. Start pulling live market-structure data via REST API.
Get your API key