CoinBoss Genel API

Kripto türevleri ve piyasa verileri için ücretsiz genel REST API. Bu sayfa; tasfiyeler, açık pozisyon, fonlama oranları, long/short oranı, opsiyonlar, borsalar, ETF ve göstergeleri kapsayan 65 temel uç noktayı belgeler. Daha fazla uç nokta önümüzdeki dönemlerde belgelenecektir.

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

Şu anda kayıtlı tüm kullanıcılar varsayılan olarak Professional katmanını alır (dakikada 1.200 istek, sınırlı süre için ücretsiz). Anahtarsız anonim çağrılar da aynı hız sınırından yararlanır. Daha net kullanım takibi için hesap merkezinizde bir API anahtarı oluşturun. Hesap Merkezinde API Anahtarı Oluştur →

Liquidations10 uç nokta

GET/api/liquidations/overview

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

Örnek İstek
curl -s "https://api.coinboss.com/api/liquidations/overview"
Örnek Yanıt
{"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.

Parametreler
AdTürZorunluAçıklamaÖrnek
rangestringisteğe bağlıTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintisteğe bağlıMax rows, default 30, max 20030
Örnek İstek
curl -s "https://api.coinboss.com/api/liquidations/coins?range=24h&limit=30"
Örnek Yanıt
{"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.

Parametreler
AdTürZorunluAçıklamaÖrnek
rangestringisteğe bağlıTime window: 1h | 4h | 12h | 24h, default 24h24h
Örnek İstek
curl -s "https://api.coinboss.com/api/liquidations/exchanges?range=24h"
Örnek Yanıt
{"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.

Parametreler
AdTürZorunluAçıklamaÖrnek
rangestringisteğe bağlıTime window: 1h | 4h | 12h | 24h, default 24h24h
limitintisteğe bağlıMax rows, default 20, max 100020
Örnek İstek
curl -s "https://api.coinboss.com/api/liquidations/largest?range=24h&limit=20"
Örnek Yanıt
{"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.

Parametreler
AdTürZorunluAçıklamaÖrnek
symbolstringisteğe bağlıTrading pair filter, e.g. BTCUSDTBTCUSDT
exchangestringisteğe bağlıExchange filter (lowercase)binance
limitintisteğe bağlıMax rows, default 50, max 100050
offsetintisteğe bağlıPagination offset, default 00
Örnek İstek
curl -s "https://api.coinboss.com/api/liquidations?symbol=BTCUSDT&limit=50"
Örnek Yanıt
{"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).

Parametreler
AdTürZorunluAçıklamaÖrnek
symbolstringisteğe bağlıTrading pair, default BTCUSDTBTCUSDT
Örnek İstek
curl -s "https://api.coinboss.com/api/liquidations/chart?symbol=BTCUSDT"
Örnek Yanıt
{"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).

Parametreler
AdTürZorunluAçıklamaÖrnek
symbolstringisteğe bağlıCoin symbol, default BTCBTC
rangestringisteğe bağlı12h | 24h | 3d | 7d | 1M, default 24h24h
modelintisteğe bağlıHeatmap model: 2 (default) or 32
Örnek İstek
curl -s "https://api.coinboss.com/api/liq-heatmap?symbol=BTC&range=24h"
Örnek Yanıt
{"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.

Parametreler
AdTürZorunluAçıklamaÖrnek
symbolstringisteğe bağlıCoin symbol, default BTCBTC
rangestringisteğe bağlı1d | 7d, default 1d1d
Örnek İstek
curl -s "https://api.coinboss.com/api/liq-map?symbol=BTC&range=1d"
Örnek Yanıt
{"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).

Parametreler
AdTürZorunluAçıklamaÖrnek
symbolstringisteğe bağlıCoin symbol, default BTCBTC
Örnek İstek
curl -s "https://api.coinboss.com/api/liq-levels?symbol=BTC"
Örnek Yanıt
{"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.

Parametreler
AdTürZorunluAçıklamaÖrnek
symbolstringisteğe bağlıCoin symbol, default BTCBTC
Örnek İstek
curl -s "https://api.coinboss.com/api/liq-maxpain?symbol=BTC"
Örnek Yanıt
{"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":{...}}}