24h 거래량—미결제약정—24h 청산$143.14M24h 롱/숏—BTC 점유율—ETH 점유율—

앱

언어 ▾

₩ KRW ▾

CoinBoss 공개 API

암호화폐 파생상품 및 시장 데이터를 위한 무료 공개 REST API입니다. 이 페이지는 청산, 미결제약정, 펀딩비, 롱숏비율, 옵션, 거래소, ETF, 지표를 포함한 65개의 핵심 엔드포인트를 다룹니다. 더 많은 엔드포인트가 향후 배치로 추가될 예정입니다.

기본 URL:https://api.coinboss.com

현재 모든 가입 사용자는 기본적으로 Professional 등급 혜택(분당 1,200회 요청, 한시적 무료)을 받습니다. 키 없는 익명 호출도 동일한 제한을 받습니다. 계정 센터에서 API 키를 생성하면 사용량을 더 명확하게 추적할 수 있습니다. 계정 센터에서 API 키 생성 →

현재 모든 엔드포인트는 누구나 무료로 이용할 수 있습니다. 유료 요금제가 곧 출시됩니다 — 가격 보기 →

Liquidations엔드포인트 10개

GET/api/liquidations/overview

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

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`range`	string	선택	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	선택	Max rows, default 30, max 200	`30`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`range`	string	선택	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`range`	string	선택	Time window: 1h \| 4h \| 12h \| 24h, default 24h	`24h`
`limit`	int	선택	Max rows, default 20, max 1000	`20`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`symbol`	string	선택	Trading pair filter, e.g. BTCUSDT	`BTCUSDT`
`exchange`	string	선택	Exchange filter (lowercase)	`binance`
`limit`	int	선택	Max rows, default 50, max 1000	`50`
`offset`	int	선택	Pagination offset, default 0	`0`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`symbol`	string	선택	Trading pair, default BTCUSDT	`BTCUSDT`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`symbol`	string	선택	Coin symbol, default BTC	`BTC`
`range`	string	선택	12h \| 24h \| 3d \| 7d \| 1M, default 24h	`24h`
`model`	int	선택	Heatmap model: 2 (default) or 3	`2`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`symbol`	string	선택	Coin symbol, default BTC	`BTC`
`range`	string	선택	1d \| 7d, default 1d	`1d`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`symbol`	string	선택	Coin symbol, default BTC	`BTC`

요청 예시

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

응답 예시

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

파라미터

이름	타입	필수 여부	설명	예시
`symbol`	string	선택	Coin symbol, default BTC	`BTC`

요청 예시

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

응답 예시

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