Volumen 24h—Interés abierto—Liquidaciones 24h$113.21M Largo/Corto 24h—Dominancia BTC—Dominancia ETH—

App

Idioma ▾

€ EUR ▾

API Pública de CoinBoss

API REST pública y gratuita para datos de derivados y mercado cripto. Esta página documenta 65 endpoints principales que cubren liquidaciones, interés abierto, tasas de financiación, ratio largo/corto, opciones, exchanges, ETF e indicadores. Se documentarán más endpoints en próximos lotes.

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

Todos los usuarios registrados obtienen actualmente el nivel Professional por defecto (1200 req/min, gratis por tiempo limitado). Las llamadas anónimas sin clave disfrutan del mismo límite de velocidad. Genera una API Key en tu centro de cuenta para un seguimiento de uso más claro. Genera una API Key en el Centro de cuenta →

Actualmente todos los endpoints son gratuitos para todos. Los planes de pago llegarán pronto — ver precios →

Liquidations10 endpoints

GET/api/liquidations/overview

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

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`range`	string	opcional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	opcional	Max rows, default 30, max 200	`30`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`range`	string	opcional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`range`	string	opcional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	opcional	Max rows, default 20, max 1000	`20`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`symbol`	string	opcional	Trading pair filter, e.g. BTCUSDT	`BTCUSDT`
`exchange`	string	opcional	Exchange filter (lowercase)	`binance`
`limit`	int	opcional	Max rows, default 50, max 1000	`50`
`offset`	int	opcional	Pagination offset, default 0	`0`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`symbol`	string	opcional	Trading pair, default BTCUSDT	`BTCUSDT`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`
`range`	string	opcional	12h \| 24h \| 3d \| 7d \| 1M, default 24h	`24h`
`model`	int	opcional	Heatmap model: 2 (default) or 3	`2`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`
`range`	string	opcional	1d \| 7d, default 1d	`1d`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción	Ejemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`

Solicitud de ejemplo

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

Respuesta de ejemplo

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