Публичный API CoinBoss

Бесплатный публичный REST API для данных по крипто-деривативам и рынку. На этой странице описаны 65 основных эндпоинтов, охватывающих ликвидации, открытый интерес, ставки финансирования, соотношение лонг/шорт, опционы, биржи, ETF и индикаторы. Дополнительные эндпоинты будут документироваться в следующих партиях.

Базовый URL:https://api.coinboss.com

В настоящее время все зарегистрированные пользователи по умолчанию получают тариф Professional (1200 запросов/мин, бесплатно на ограниченный срок). Анонимные вызовы без ключа имеют тот же лимит. Создайте API-ключ в личном кабинете для более точного учёта использования. Создать API-ключ в личном кабинете →

Liquidations10 эндпоинтов

GET/api/liquidations/overview

Aggregated liquidation totals (long/short/total USD + count) over 1h/4h/12h/24h windows.

Пример запроса
curl -s "https://api.coinboss.com/api/liquidations/overview"
Пример ответа
{"success":true,"data":{"1h":{"long_usd":2514926.33,"short_usd":1745806.99,"total_usd":4260733.32,"cnt":3442},"4h":{"long_usd":22979554.28,"short_usd":13398258.11,"total_usd":36377812.39,"cnt":20321},"12h":{...},"24h":{"long_usd":338813602.47,"short_usd":113217406.7,"total_usd":452031009.17,"cnt":137148}}}
GET/api/liquidations/coins

Per-coin liquidation ranking (long/short/total USD + count) within a time window.

Параметры
ИмяТипОбязательноОписаниеПример
rangestringнеобязательноTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintнеобязательноMax rows, default 30, max 20030
Пример запроса
curl -s "https://api.coinboss.com/api/liquidations/coins?range=24h&limit=30"
Пример ответа
{"success":true,"data":[{"coin":"BTC","long_usd":72545468.67,"short_usd":30686931.83,"total_usd":103232400.5,"cnt":6999},{"coin":"ETH","long_usd":65991403,"short_usd":34063817.96,"total_usd":100055220.96,"cnt":7476},...]}
GET/api/liquidations/exchanges

Per-exchange liquidation totals within a time window.

Параметры
ИмяТипОбязательноОписаниеПример
rangestringнеобязательноTime window: 1h | 4h | 12h | 24h, default 24h24h
Пример запроса
curl -s "https://api.coinboss.com/api/liquidations/exchanges?range=24h"
Пример ответа
{"success":true,"data":[{"exchange":"binance","long_usd":"164172413.09","short_usd":"56852546.14","total_usd":"221024959.23","cnt":62125},{"exchange":"okx","long_usd":"82190154.26",...},...]}
GET/api/liquidations/largest

Largest single liquidation orders within a time window.

Параметры
ИмяТипОбязательноОписаниеПример
rangestringнеобязательноTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintнеобязательноMax rows, default 20, max 100020
Пример запроса
curl -s "https://api.coinboss.com/api/liquidations/largest?range=24h&limit=20"
Пример ответа
{"success":true,"data":[{"exchange":"binance","symbol":"ETHUSDT","side":"SHORT","price":"1826.14000000","qty":"4000.69400000","value_usd":"7305827.34","timestamp":1783443128089},...]}
GET/api/liquidations

Raw liquidation order feed with optional symbol/exchange filter and pagination.

Параметры
ИмяТипОбязательноОписаниеПример
symbolstringнеобязательноTrading pair filter, e.g. BTCUSDTBTCUSDT
exchangestringнеобязательноExchange filter (lowercase)binance
limitintнеобязательноMax rows, default 50, max 100050
offsetintнеобязательноPagination offset, default 00
Пример запроса
curl -s "https://api.coinboss.com/api/liquidations?symbol=BTCUSDT&limit=50"
Пример ответа
{"success":true,"data":[{"exchange":"binance","symbol":"BTCUSDT","side":"LONG","price":"61521.10","qty":"0.028","value_usd":"1722.59","timestamp":1783515540991},...]}
GET/api/liquidations/chart

Hourly liquidation chart (long/short USD per hour, last 24h, fixed window).

Параметры
ИмяТипОбязательноОписаниеПример
symbolstringнеобязательноTrading pair, default BTCUSDTBTCUSDT
Пример запроса
curl -s "https://api.coinboss.com/api/liquidations/chart?symbol=BTCUSDT"
Пример ответа
{"success":true,"data":[{"hour":"1783429200000","side":"LONG","total_usd":"91606.13"},{"hour":"1783432800000","side":"LONG","total_usd":"494223.02"},{"hour":"1783432800000","side":"SHORT","total_usd":"86447.22"},...]}
GET/api/liq-heatmap

Liquidation heatmap matrix: price levels × time with liquidation intensity (model 2/3).

Параметры
ИмяТипОбязательноОписаниеПример
symbolstringнеобязательноCoin symbol, default BTCBTC
rangestringнеобязательно12h | 24h | 3d | 7d | 1M, default 24h24h
modelintнеобязательноHeatmap model: 2 (default) or 32
Пример запроса
curl -s "https://api.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"
Пример ответа
{"symbol":"BTC","range":"24h","model":2,"updatedAt":1783515540991,"currentPrice":62125,"prices":[59255,59285.25,...],"times":[...],"matrix":[...]}
GET/api/liq-map

Liquidation map: cumulative estimated liquidation bins by price and leverage tier.

Параметры
ИмяТипОбязательноОписаниеПример
symbolstringнеобязательноCoin symbol, default BTCBTC
rangestringнеобязательно1d | 7d, default 1d1d
Пример запроса
curl -s "https://api.coinboss.com/api/liq-map?symbol=BTC&range=1d"
Пример ответа
{"symbol":"BTC","range":"1d","updatedAt":1783515540291,"currentPrice":62125,"binWidth":62.125,"leverages":[10,25,50,100],"bins":[{"price":56067.81,"side":"long","tiers":{"10":19367594},"total":19367594},...]}
GET/api/liq-levels

Key liquidation price levels and intensity per leverage tier (10/25/50/100x).

Параметры
ИмяТипОбязательноОписаниеПример
symbolstringнеобязательноCoin symbol, default BTCBTC
Пример запроса
curl -s "https://api.coinboss.com/api/liq-levels?symbol=BTC"
Пример ответа
{"success":true,"data":{"symbol":"BTC","price":62125,"updatedAt":1783515540291,"tiers":{"10":{"longPrice":56161,"longIntensity":27783809,"shortPrice":68089,"shortIntensity":27783809},"25":{...},"50":{...},"100":{...}}}}
GET/api/liq-maxpain

Liquidation max-pain: strongest long/short liquidation cluster within 1d/7d ranges.

Параметры
ИмяТипОбязательноОписаниеПример
symbolstringнеобязательноCoin symbol, default BTCBTC
Пример запроса
curl -s "https://api.coinboss.com/api/liq-maxpain?symbol=BTC"
Пример ответа
{"success":true,"data":{"symbol":"BTC","price":62125,"updatedAt":1783515540291,"d1":{"long":{"price":56067.81,"usd":19367594,"distPct":-9.75},"short":{"price":64206.19,"usd":13452844,"distPct":3.35},"totalLong":227148221,"totalShort":205467709},"d7":{...}}}