24h Volume—Open Interest—24h Liquidations$247.52M 24h Long/Short—BTC Dominance—ETH Dominance—

App

Language ▾

$ USD ▾

CoinBoss Public API

Free public REST API for crypto derivatives and market data. This page documents 65 core endpoints covering liquidations, open interest, funding rates, long/short ratio, options, exchanges, ETF and indicators. More endpoints are being documented in upcoming batches.

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

All registered users currently get the Professional tier by default (1,200 req/min, free for a limited time). Anonymous calls without a key enjoy the same rate limit cap. Generate an API key in your account center for clearer usage tracking. Generate an API Key in Account Center →

All endpoints are currently free for everyone. Paid tiers are coming soon — view pricing →

Liquidations10 endpoints

GET/api/liquidations/overview

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

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`range`	string	optional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	optional	Max rows, default 30, max 200	`30`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`range`	string	optional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`range`	string	optional	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	optional	Max rows, default 20, max 1000	`20`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`symbol`	string	optional	Trading pair filter, e.g. BTCUSDT	`BTCUSDT`
`exchange`	string	optional	Exchange filter (lowercase)	`binance`
`limit`	int	optional	Max rows, default 50, max 1000	`50`
`offset`	int	optional	Pagination offset, default 0	`0`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`symbol`	string	optional	Trading pair, default BTCUSDT	`BTCUSDT`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`symbol`	string	optional	Coin symbol, default BTC	`BTC`
`range`	string	optional	12h \| 24h \| 3d \| 7d \| 1M, default 24h	`24h`
`model`	int	optional	Heatmap model: 2 (default) or 3	`2`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`symbol`	string	optional	Coin symbol, default BTC	`BTC`
`range`	string	optional	1d \| 7d, default 1d	`1d`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`symbol`	string	optional	Coin symbol, default BTC	`BTC`

Example Request

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

Example Response

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

Parameters

Name	Type	Required	Description	Example
`symbol`	string	optional	Coin symbol, default BTC	`BTC`

Example Request

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

Example Response

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