Volume 24h—Open Interest—Liquidazioni 24h$272.94M Long/Short 24h—Dominanza BTC—Dominanza ETH—

App

Lingua ▾

€ EUR ▾

API pubblica CoinBoss

API REST pubblica e gratuita per dati sui derivati crypto e di mercato. Questa pagina documenta 65 endpoint principali che coprono liquidazioni, open interest, tassi di finanziamento, rapporto long/short, opzioni, exchange, ETF e indicatori. Ulteriori endpoint verranno documentati nei prossimi aggiornamenti.

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

Attualmente tutti gli utenti registrati ottengono per impostazione predefinita il livello Professional (1.200 richieste/min, gratuito per un periodo limitato). Le chiamate anonime senza chiave beneficiano dello stesso limite. Genera una chiave API nel tuo centro account per un monitoraggio dell'utilizzo più chiaro. Genera una chiave API nel Centro Account →

Attualmente tutti gli endpoint sono gratuiti per tutti. I piani a pagamento arriveranno presto — visualizza i prezzi →

Liquidations10 endpoint

GET/api/liquidations/overview

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

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`range`	string	opzionale	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	opzionale	Max rows, default 30, max 200	`30`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`range`	string	opzionale	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`range`	string	opzionale	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	opzionale	Max rows, default 20, max 1000	`20`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`symbol`	string	opzionale	Trading pair filter, e.g. BTCUSDT	`BTCUSDT`
`exchange`	string	opzionale	Exchange filter (lowercase)	`binance`
`limit`	int	opzionale	Max rows, default 50, max 1000	`50`
`offset`	int	opzionale	Pagination offset, default 0	`0`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`symbol`	string	opzionale	Trading pair, default BTCUSDT	`BTCUSDT`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`symbol`	string	opzionale	Coin symbol, default BTC	`BTC`
`range`	string	opzionale	12h \| 24h \| 3d \| 7d \| 1M, default 24h	`24h`
`model`	int	opzionale	Heatmap model: 2 (default) or 3	`2`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`symbol`	string	opzionale	Coin symbol, default BTC	`BTC`
`range`	string	opzionale	1d \| 7d, default 1d	`1d`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`symbol`	string	opzionale	Coin symbol, default BTC	`BTC`

Esempio di richiesta

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

Esempio di risposta

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

Parametri

Nome	Tipo	Obbligatorio	Descrizione	Esempio
`symbol`	string	opzionale	Coin symbol, default BTC	`BTC`

Esempio di richiesta

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

Esempio di risposta

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