Liquidation Map API
Access real-time liquidation data through our API. Integrate powerful liquidation map analytics into your trading systems.
Supercharge Your Trading
Institutional-grade data precision. 40% more accurate liquidation detection than competitors. 100% coverage of hidden liquidity clusters across major exchanges.
- Detect reversal zones before price moves with hidden liquidity cluster analysis
- Production-ready Python client with comprehensive error handling
- Backtest strategies with 3+ years of historical liquidation data
- See what retail traders can't: 100% coverage vs ~60% from competitors
- Options-aware trading with gamma exposure data showing dealer positioning
Transform your trading strategy with data that reveals what others miss.

What You Can Build
Liquidation-based Strategies
Detect hidden liquidity clusters before price reacts. Backtest 5+ years of historical data to identify reversal zones with institutional precision.
Options-aware Trading
Gamma exposure (GEX+) data shows dealer positioning in real-time. Combine with liquidation clusters for multi-signal confluence.
Toxic Flow Alerts
Track large orders moving markets with TOF endpoints. Identify when smart money is active and capitalize on institutional positioning.
Multi-exchange Arbitrage
Aggregate liquidation data across exchanges instantly. Spot dispersion opportunities and price inefficiencies before they disappear.
Forge Your Edge
Join quantitative trading firms, algorithmic traders, and hedge funds using Kingfisher data to build competitive advantages.
API Documentation
Quick start guide to integrate liquidation maps into your trading applications
Authentication
All API requests require your API key in the header:
X-API-Key: kf_your_api_key_hereExample request:GET https://app.thekingfisher.io/api/api-subscription/status
Available Endpoints
Different endpoints consume different amounts of credits per request
| Endpoint | Credits | Method | Description |
|---|---|---|---|
| Map (Liquidation Map) | 1 | POST /api/map/latest | params: pair, exchange, type |
| Map (Liquidation Map) | 5 | POST /api/map/latest | multi exchange |
| Map (by timestamp) | 1 | POST /api/map/timestamp | params: pair, exchange, type, ts |
| Liq Ratios | 5 | POST /api/ratios/latest | param: map_type |
| TOF (Toxic Order Flow) | 1 | GET /api/tof/get_available | Get available trading pairs |
| TOF (Toxic Order Flow) | 1 | POST /api/tof | params: pair ("BTCUSDT", "ETHUSDT"), tf ("5m", "1h", "4h") |
| GEX (Gamma Exposure) | 2 | POST /api/map/gevex | param: instrument ("BTC" or "ETH") |
| RSI | 1 | POST /api/rsi | param: tf ("5m", "15m", "1h", "4h", "1d") |
| Market Surge | 1 | GET /api/markets-surge | Get trending/volatile assets |
| Usage & Status | FREE | GET /api/api-subscription/usage | Get current credit usage |
| Usage & Status | FREE | GET /api/api-subscription/instruments | Get allowed instruments |
Python Integration Example
Here's a quick example to get you started:
import requests
# Configure your API key
API_KEY = "kf_your_api_key_here"
BASE_URL = "https://app.thekingfisher.io/api"
headers = {
"X-API-Key": API_KEY,
"Content-Type": "application/json"
}
# Get latest liquidation map
response = requests.post(
f"{BASE_URL}/map/latest",
headers=headers,
json={
"pair": "BTCUSDT",
"exchange": "binance",
"type": "perpetual"
}
)
data = response.json()
print(f"Liquidation Map Data: {data}")A complete Python client is provided to API subscribers with advanced features and error handling. Get API access
API Pricing
Choose the plan that fits your trading needs
API Credit Consumption
Different endpoints consume different amounts of credits per request
Example: With the Professional tier's 5,000 monthly credits, you could make:
- 5,000 Liq Map queries, or
- 2,500 GEX queries, or
- 1,000 Aggregated Orderbook queries
Ready to Get Started?
Join thousands of traders using Kingfisher API to power their trading strategies.

