API công khai CoinBoss

API REST công khai miễn phí cho dữ liệu phái sinh tiền điện tử và thị trường. Trang này ghi lại 65 điểm cuối cốt lõi bao gồm thanh lý, khối lượng vị thế mở, tỷ lệ funding, tỷ lệ long/short, quyền chọn, sàn giao dịch, ETF và các chỉ số. Nhiều điểm cuối hơn đang được ghi lại trong các đợt sắp tới.

URL cơ sở:https://api.coinboss.com

Hiện tất cả người dùng đã đăng ký mặc định nhận gói Professional (1.200 yêu cầu/phút, miễn phí trong thời gian giới hạn). Các cuộc gọi ẩn danh không có khóa cũng được hưởng giới hạn tương tự. Tạo khóa API trong trung tâm tài khoản của bạn để theo dõi mức sử dụng rõ ràng hơn. Tạo khóa API trong Trung tâm tài khoản →

Liquidations10 điểm cuối

GET/api/liquidations/overview

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

Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liquidations/overview"
Ví dụ phản hồi
{"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.

Tham số
TênLoạiBắt buộcMô tảVí dụ
rangestringtùy chọnTime window: 1h | 4h | 12h | 24h, default 24h24h
limitinttùy chọnMax rows, default 30, max 20030
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liquidations/coins?range=24h&limit=30"
Ví dụ phản hồi
{"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.

Tham số
TênLoạiBắt buộcMô tảVí dụ
rangestringtùy chọnTime window: 1h | 4h | 12h | 24h, default 24h24h
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liquidations/exchanges?range=24h"
Ví dụ phản hồi
{"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.

Tham số
TênLoạiBắt buộcMô tảVí dụ
rangestringtùy chọnTime window: 1h | 4h | 12h | 24h, default 24h24h
limitinttùy chọnMax rows, default 20, max 100020
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liquidations/largest?range=24h&limit=20"
Ví dụ phản hồi
{"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.

Tham số
TênLoạiBắt buộcMô tảVí dụ
symbolstringtùy chọnTrading pair filter, e.g. BTCUSDTBTCUSDT
exchangestringtùy chọnExchange filter (lowercase)binance
limitinttùy chọnMax rows, default 50, max 100050
offsetinttùy chọnPagination offset, default 00
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liquidations?symbol=BTCUSDT&limit=50"
Ví dụ phản hồi
{"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).

Tham số
TênLoạiBắt buộcMô tảVí dụ
symbolstringtùy chọnTrading pair, default BTCUSDTBTCUSDT
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liquidations/chart?symbol=BTCUSDT"
Ví dụ phản hồi
{"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).

Tham số
TênLoạiBắt buộcMô tảVí dụ
symbolstringtùy chọnCoin symbol, default BTCBTC
rangestringtùy chọn12h | 24h | 3d | 7d | 1M, default 24h24h
modelinttùy chọnHeatmap model: 2 (default) or 32
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"
Ví dụ phản hồi
{"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.

Tham số
TênLoạiBắt buộcMô tảVí dụ
symbolstringtùy chọnCoin symbol, default BTCBTC
rangestringtùy chọn1d | 7d, default 1d1d
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liq-map?symbol=BTC&range=1d"
Ví dụ phản hồi
{"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).

Tham số
TênLoạiBắt buộcMô tảVí dụ
symbolstringtùy chọnCoin symbol, default BTCBTC
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liq-levels?symbol=BTC"
Ví dụ phản hồi
{"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.

Tham số
TênLoạiBắt buộcMô tảVí dụ
symbolstringtùy chọnCoin symbol, default BTCBTC
Ví dụ yêu cầu
curl -s "https://api.coinboss.com/api/liq-maxpain?symbol=BTC"
Ví dụ phản hồi
{"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":{...}}}