LiqSonar API
Pump events, the liquidation map, order-flow signals and the cross-exchange verdict as JSON. Included in Pro; 60 requests per minute per key.
Your API key
…
Authentication
Send the key in the X-API-Key header (or Authorization: Bearer). The key works while your Pro is active.
curl -H "X-API-Key: lsk_..." "https://oracle-web-production-17ab.up.railway.app/api/v1/pumps?days=7"
Endpoints
| Endpoint | Query parameters (default) | Returns |
|---|---|---|
GET /api/v1/pumps | days=1–90 (7), limit=1–200 (50) | Detected pumps and dumps with prices, timing, volume surge, open interest and liquidation volume, and the AI summary when available. Pass lang=en or lang=ru for the summary language (English by default). |
GET /api/v1/liquidation-levels/{symbol} | days=1|3|7 (1) | Estimated USD of long and short liquidations per price bin within ±12% of the price. |
GET /api/v1/signals | symbol, hours=1–168 (24), limit=1–1000 (200) | Order-flow signals on Binance futures: divergences, absorption, pressure, CVD flips, funding and volume spikes. Thresholds are still being calibrated. |
GET /api/v1/verdict/{symbol} | hours=1–24 (4) | Whether price moves with or against the order flow on Binance, Bybit, OKX and Bitget. |
Errors
401 — missing, unknown or revoked key; 402 — Pro has ended; 429 — more than 60 requests per minute. All errors return JSON with an error field.