Long and short accounts per exchange
The share of accounts long and short on each exchange for one coin, as Coinalyze last reported it when the Decryptr app asked (cached by Decryptr; fetched_at says when). Ordered by exchange name.
Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data.
Cost: 1 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (and is refused with 429 if that many are not available), then pays only for what came back.
Needs scope derivatives:read and the starter plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
asset*stringAsset symbol, letters and digits, case-insensitive (required).
^[A-Za-z0-9]{1,15}$limit?integerItems to return, 1 to 100. Your plan allows max_page calls per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's calls per item. Default 20, or that maximum if lower. The request reserves limit x calls per item before it runs: ask only for what you need.
1 <= value <= 100OK.
application/json- response
data*array<>as_of*stringWhen the response was made.
date-timeattribution*stringAttribution you must keep with this data.
disclaimer*stringPlain-language notice. Information only, not financial advice.
meta*Where the figures come from.
curl -X GET 'https://data.decryptr.ai/v1/market/long-short/exchanges?asset=BTC&limit=10'{ "data": [ { "asset": "BTC", "exchange": "Binance", "symbol": "BTCUSDT_PERP.A", "at": "2026-10-23T12:00:00.000Z", "fetched_at": "2026-10-23T12:00:00.000Z", "ratio": 2.4, "long_pct": 70.6, "short_pct": 29.4 }, { "asset": "BTC", "exchange": "Bybit", "symbol": "BTCUSDT_PERP.A", "at": "2026-10-23T12:00:00.000Z", "fetched_at": "2026-10-23T12:00:00.000Z", "ratio": 2.1, "long_pct": 67.7, "short_pct": 32.3 } ], "as_of": "2026-10-23T12:12:30.000Z", "attribution": "Includes data from Coinalyze.", "disclaimer": "Information only, not financial advice.", "meta": { "source": "Coinalyze, as cached by Decryptr" }}Long and short ratios (Binance) GET
Binance USD-M long to short ratios every 5 minutes, newest first: top traders' accounts and positions, all accounts, and taker volume. A ratio above 1 means more long than short. Kept by Decryptr for about 30 major coins. Not found when the archive holds none. Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data. Cost: 1 call per item returned, at least one item's worth. The request first reserves limit x 1 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `derivatives:read` and the starter plan or above.
Liquidation heatmap history GET
Where open Hyperliquid positions on one asset would be liquidated, summed into equal price buckets (bucket i covers price_floor + i x bucket_size up to the next), newest first: every 10 minutes for 7 days, then hourly. Snapshots resting on fewer than 5 accounts are left out and no address is ever shown. Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data. Cost: 2 calls per item returned, at least one item's worth. The request first reserves limit x 2 calls (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `liquidations:read` and the starter plan or above.