Volume 24h—Positions ouvertes—Liquidations 24h$142.38M Long/Short 24h—Dominance BTC—Dominance ETH—

App

Langue ▾

€ EUR ▾

API publique CoinBoss

API REST publique gratuite pour les données de dérivés crypto et de marché. Cette page documente 65 points de terminaison principaux couvrant les liquidations, positions ouvertes, taux de financement, ratio long/short, options, échanges, ETF et indicateurs. D'autres points de terminaison seront documentés dans de prochains lots.

URL de base :https://api.coinboss.com

Tous les utilisateurs inscrits bénéficient actuellement par défaut du niveau Professional (1 200 requêtes/min, gratuit pour une durée limitée). Les appels anonymes sans clé bénéficient de la même limite. Générez une clé API dans votre centre de compte pour un suivi d'utilisation plus clair. Générer une clé API dans le centre de compte →

Tous les points de terminaison sont actuellement gratuits pour tous. Des offres payantes arrivent bientôt — voir les tarifs →

Liquidations10 points de terminaison

GET/api/liquidations/overview

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

Exemple de requête

curl -s "https://api.coinboss.com/api/liquidations/overview"

Exemple de réponse

{"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.

Paramètres

Nom	Type	Requis	Description	Exemple
`range`	string	optionnel	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	optionnel	Max rows, default 30, max 200	`30`

Exemple de requête

curl -s "https://api.coinboss.com/api/liquidations/coins?range=24h&limit=30"

Exemple de réponse

{"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.

Paramètres

Nom	Type	Requis	Description	Exemple
`range`	string	optionnel	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`

Exemple de requête

curl -s "https://api.coinboss.com/api/liquidations/exchanges?range=24h"

Exemple de réponse

{"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.

Paramètres

Nom	Type	Requis	Description	Exemple
`range`	string	optionnel	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	optionnel	Max rows, default 20, max 1000	`20`

Exemple de requête

curl -s "https://api.coinboss.com/api/liquidations/largest?range=24h&limit=20"

Exemple de réponse

{"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.

Paramètres

Nom	Type	Requis	Description	Exemple
`symbol`	string	optionnel	Trading pair filter, e.g. BTCUSDT	`BTCUSDT`
`exchange`	string	optionnel	Exchange filter (lowercase)	`binance`
`limit`	int	optionnel	Max rows, default 50, max 1000	`50`
`offset`	int	optionnel	Pagination offset, default 0	`0`

Exemple de requête

curl -s "https://api.coinboss.com/api/liquidations?symbol=BTCUSDT&limit=50"

Exemple de réponse

{"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).

Paramètres

Nom	Type	Requis	Description	Exemple
`symbol`	string	optionnel	Trading pair, default BTCUSDT	`BTCUSDT`

Exemple de requête

curl -s "https://api.coinboss.com/api/liquidations/chart?symbol=BTCUSDT"

Exemple de réponse

{"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).

Paramètres

Nom	Type	Requis	Description	Exemple
`symbol`	string	optionnel	Coin symbol, default BTC	`BTC`
`range`	string	optionnel	12h \| 24h \| 3d \| 7d \| 1M, default 24h	`24h`
`model`	int	optionnel	Heatmap model: 2 (default) or 3	`2`

Exemple de requête

curl -s "https://api.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"

Exemple de réponse

{"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.

Paramètres

Nom	Type	Requis	Description	Exemple
`symbol`	string	optionnel	Coin symbol, default BTC	`BTC`
`range`	string	optionnel	1d \| 7d, default 1d	`1d`

Exemple de requête

curl -s "https://api.coinboss.com/api/liq-map?symbol=BTC&range=1d"

Exemple de réponse

{"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).

Paramètres

Nom	Type	Requis	Description	Exemple
`symbol`	string	optionnel	Coin symbol, default BTC	`BTC`

Exemple de requête

curl -s "https://api.coinboss.com/api/liq-levels?symbol=BTC"

Exemple de réponse

{"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.

Paramètres

Nom	Type	Requis	Description	Exemple
`symbol`	string	optionnel	Coin symbol, default BTC	`BTC`

Exemple de requête

curl -s "https://api.coinboss.com/api/liq-maxpain?symbol=BTC"

Exemple de réponse

{"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":{...}}}