CoinBoss Öffentliche API

Kostenlose öffentliche REST-API für Krypto-Derivate- und Marktdaten. Diese Seite dokumentiert 65 zentrale Endpunkte für Liquidationen, Open Interest, Finanzierungsraten, Long/Short-Verhältnis, Optionen, Börsen, ETF und Indikatoren. Weitere Endpunkte werden in kommenden Chargen dokumentiert.

Basis-URL:https://api.coinboss.com

Alle registrierten Nutzer erhalten derzeit standardmäßig die Professional-Stufe (1.200 Anfragen/Min., zeitlich begrenzt kostenlos). Anonyme Aufrufe ohne Schlüssel unterliegen demselben Limit. Erstellen Sie einen API-Schlüssel in Ihrem Kontobereich für eine klarere Nutzungsverfolgung. API-Schlüssel im Kontobereich erstellen →

Liquidations10 Endpunkte

GET/api/liquidations/overview

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

Beispielanfrage
curl -s "https://api.coinboss.com/api/liquidations/overview"
Beispielantwort
{"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.

Parameter
NameTypErforderlichBeschreibungBeispiel
rangestringoptionalTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintoptionalMax rows, default 30, max 20030
Beispielanfrage
curl -s "https://api.coinboss.com/api/liquidations/coins?range=24h&limit=30"
Beispielantwort
{"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.

Parameter
NameTypErforderlichBeschreibungBeispiel
rangestringoptionalTime window: 1h | 4h | 12h | 24h, default 24h24h
Beispielanfrage
curl -s "https://api.coinboss.com/api/liquidations/exchanges?range=24h"
Beispielantwort
{"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.

Parameter
NameTypErforderlichBeschreibungBeispiel
rangestringoptionalTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintoptionalMax rows, default 20, max 100020
Beispielanfrage
curl -s "https://api.coinboss.com/api/liquidations/largest?range=24h&limit=20"
Beispielantwort
{"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.

Parameter
NameTypErforderlichBeschreibungBeispiel
symbolstringoptionalTrading pair filter, e.g. BTCUSDTBTCUSDT
exchangestringoptionalExchange filter (lowercase)binance
limitintoptionalMax rows, default 50, max 100050
offsetintoptionalPagination offset, default 00
Beispielanfrage
curl -s "https://api.coinboss.com/api/liquidations?symbol=BTCUSDT&limit=50"
Beispielantwort
{"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).

Parameter
NameTypErforderlichBeschreibungBeispiel
symbolstringoptionalTrading pair, default BTCUSDTBTCUSDT
Beispielanfrage
curl -s "https://api.coinboss.com/api/liquidations/chart?symbol=BTCUSDT"
Beispielantwort
{"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).

Parameter
NameTypErforderlichBeschreibungBeispiel
symbolstringoptionalCoin symbol, default BTCBTC
rangestringoptional12h | 24h | 3d | 7d | 1M, default 24h24h
modelintoptionalHeatmap model: 2 (default) or 32
Beispielanfrage
curl -s "https://api.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"
Beispielantwort
{"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.

Parameter
NameTypErforderlichBeschreibungBeispiel
symbolstringoptionalCoin symbol, default BTCBTC
rangestringoptional1d | 7d, default 1d1d
Beispielanfrage
curl -s "https://api.coinboss.com/api/liq-map?symbol=BTC&range=1d"
Beispielantwort
{"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).

Parameter
NameTypErforderlichBeschreibungBeispiel
symbolstringoptionalCoin symbol, default BTCBTC
Beispielanfrage
curl -s "https://api.coinboss.com/api/liq-levels?symbol=BTC"
Beispielantwort
{"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.

Parameter
NameTypErforderlichBeschreibungBeispiel
symbolstringoptionalCoin symbol, default BTCBTC
Beispielanfrage
curl -s "https://api.coinboss.com/api/liq-maxpain?symbol=BTC"
Beispielantwort
{"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":{...}}}