Volume 24h—Contratos em aberto—Liquidações 24h$142.88M Long/Short 24h—Dominância BTC—Dominância ETH—

App

Idioma ▾

R$ BRL ▾

API Pública da CoinBoss

API REST pública e gratuita para dados de derivativos e mercado cripto. Esta página documenta 65 endpoints principais cobrindo liquidações, open interest, taxas de financiamento, razão long/short, opções, exchanges, ETF e indicadores. Mais endpoints serão documentados em lotes futuros.

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

Todos os usuários registrados atualmente recebem o plano Professional por padrão (1.200 req/min, gratuito por tempo limitado). Chamadas anônimas sem chave têm o mesmo limite de taxa. Gere uma chave de API na sua central de conta para um rastreamento de uso mais claro. Gerar chave de API na Central de Conta →

Todos os endpoints são atualmente gratuitos para todos. Planos pagos em breve — veja os preços →

Liquidations10 endpoints

GET/api/liquidations/overview

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

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`range`	string	opcional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	opcional	Max rows, default 30, max 200	`30`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`range`	string	opcional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`range`	string	opcional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	opcional	Max rows, default 20, max 1000	`20`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`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`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`symbol`	string	opcional	Trading pair, default BTCUSDT	`BTCUSDT`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`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`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`
`range`	string	opcional	1d \| 7d, default 1d	`1d`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`

Exemplo de Requisição

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

Exemplo de Resposta

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

Nome	Tipo	Obrigatório	Descrição	Exemplo
`symbol`	string	opcional	Coin symbol, default BTC	`BTC`

Exemplo de Requisição

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

Exemplo de Resposta

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