API Publik CoinBoss

API REST publik gratis untuk data derivatif kripto dan pasar. Halaman ini mendokumentasikan 65 endpoint inti yang mencakup likuidasi, open interest, funding rate, rasio long/short, opsi, exchange, ETF, dan indikator. Endpoint lainnya sedang didokumentasikan dalam batch mendatang.

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

Saat ini semua pengguna terdaftar mendapatkan tingkat Professional secara default (1.200 permintaan/menit, gratis untuk waktu terbatas). Panggilan anonim tanpa kunci juga mendapatkan batas yang sama. Buat kunci API di pusat akun Anda untuk pelacakan penggunaan yang lebih jelas. Buat Kunci API di Pusat Akun →

Liquidations10 endpoint

GET/api/liquidations/overview

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

Contoh Permintaan
curl -s "https://api.coinboss.com/api/liquidations/overview"
Contoh Respons
{"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.

Parameter
NamaTipeWajibDeskripsiContoh
rangestringopsionalTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintopsionalMax rows, default 30, max 20030
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liquidations/coins?range=24h&limit=30"
Contoh Respons
{"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.

Parameter
NamaTipeWajibDeskripsiContoh
rangestringopsionalTime window: 1h | 4h | 12h | 24h, default 24h24h
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liquidations/exchanges?range=24h"
Contoh Respons
{"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.

Parameter
NamaTipeWajibDeskripsiContoh
rangestringopsionalTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintopsionalMax rows, default 20, max 100020
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liquidations/largest?range=24h&limit=20"
Contoh Respons
{"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.

Parameter
NamaTipeWajibDeskripsiContoh
symbolstringopsionalTrading pair filter, e.g. BTCUSDTBTCUSDT
exchangestringopsionalExchange filter (lowercase)binance
limitintopsionalMax rows, default 50, max 100050
offsetintopsionalPagination offset, default 00
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liquidations?symbol=BTCUSDT&limit=50"
Contoh Respons
{"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).

Parameter
NamaTipeWajibDeskripsiContoh
symbolstringopsionalTrading pair, default BTCUSDTBTCUSDT
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liquidations/chart?symbol=BTCUSDT"
Contoh Respons
{"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).

Parameter
NamaTipeWajibDeskripsiContoh
symbolstringopsionalCoin symbol, default BTCBTC
rangestringopsional12h | 24h | 3d | 7d | 1M, default 24h24h
modelintopsionalHeatmap model: 2 (default) or 32
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"
Contoh Respons
{"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.

Parameter
NamaTipeWajibDeskripsiContoh
symbolstringopsionalCoin symbol, default BTCBTC
rangestringopsional1d | 7d, default 1d1d
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liq-map?symbol=BTC&range=1d"
Contoh Respons
{"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).

Parameter
NamaTipeWajibDeskripsiContoh
symbolstringopsionalCoin symbol, default BTCBTC
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liq-levels?symbol=BTC"
Contoh Respons
{"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.

Parameter
NamaTipeWajibDeskripsiContoh
symbolstringopsionalCoin symbol, default BTCBTC
Contoh Permintaan
curl -s "https://api.coinboss.com/api/liq-maxpain?symbol=BTC"
Contoh Respons
{"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":{...}}}