24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/currency/overview
GETKullanılabilir

Coin ayrıntı özeti

Coin ayrıntı özeti (fiyat, piyasa değeri, arz, türev özeti)

GET/api/currency/overview

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringZorunlu——Temel coin sembolü (büyük harf, ör. BTC). Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/currency/overview?coin=BTC"

Yanıt alanları

Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.

AlanTürBirimAçıklama
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
dataobject—Veri yükü.
data.coinstring—Coin sembolü, büyük harfle (örneğin BTC).
data.supplyobject—Coin cinsinden arz.
data.supply.price_usdstring(decimal)USDFiyat.
data.supply.market_cap_usdstring(decimal)USDPiyasa değeri.
data.supply.mcap_ranknumber—Piyasa değerine göre sıra.
data.supply.vol_24h_usdstring(decimal)USD24h hacim.
data.supply.circulatingstring(decimal)—Coin cinsinden dolaşımdaki arz.
data.supply.total_supplystring(decimal)—Coin cinsinden toplam arz.
data.supply.max_supplystring(decimal)|null—Coin cinsinden maksimum arz; sınırsız ya da bilinmiyorsa null.
data.supply.change_24h_pctstring(decimal)%24h yüzde değişim.
data.supply.image_urlstring—CoinBoss'un sunduğu aynı kaynaklı (same-origin) simge yolu; doğrulanmış simge yoksa null.
data.supply.website_urlstring—Projenin resmî web sitesi; coin meta verilerinden alınır.
data.supply.reddit_urlstring|null—Projenin subreddit'i; listelenmemişse null.
data.supply.github_urlstring|null—Projenin ana kaynak kodu deposu; listelenmemişse null.
data.supply.whitepaper_urlstring—Projenin teknik dokümanının (whitepaper) bağlantısı.
data.supply.explorer_urlstring—Coin için bir blok gezgininin bağlantısı.
data.supply.categorystring—Kategori.
data.supply.asofnumbermsKullanılan en yeni verinin zamanı.
data.supply.staleboolean—Güncellik penceresinden daha eski veriler için satırlar veya bayrak.
data.supply.spot_vol_usdnumberUSDCoinin 24h spot hacminin, CoinBoss'un kendisinin topladığı spot borsalar üzerinden toplamı (en güncel anlık görüntü); toplanmıyorsa null.
data.supply.futures_vol_usdnumberUSDTicker'ı 1 saatten daha güncel olan tüm borsalardaki 24h vadeli hacmin toplamı; `futures_vol.total_usd` ile aynı değerdir. Kendi verimiz yoksa null.
data.supply.oi_total_usdnumberUSDCoinin tüm borsalar ve sözleşme türleri genelindeki toplu açık pozisyonu; `oi.total_usd` ile aynı değerdir. Kendi verimiz yoksa null.
data.supply.high_24hstring(decimal)—24h en yüksek.
data.supply.low_24hstring(decimal)—24h en düşük.
data.futures_vol_chg_pctnumber%Vadeli hacmin 24h değişimi: hem şu anda hem de yaklaşık 24 saat önceki saatlik anlık görüntüde bulunan borsalar üzerinden, (Σ güncel − Σ önceki) ÷ Σ önceki.
data.oi_chg_pctnumber%Açık pozisyonun 24h değişimi; hem şu anda hem de 24 saat öncesine en yakın saatlik anlık görüntüde bulunan sözleşmeler üzerinden hesaplanır.
data.oiobject—Açık pozisyon.
data.oi.total_usdnumberUSDToplam.
data.oi.local_usdnumberUSDCoinBoss'un borsa bazındaki kendi veri toplamasından toplanan açık pozisyon; `oi.total_usd` ile özdeştir.
data.oi.by_exchangearray—Borsa bazında dağılım.
data.oi.by_exchange[]object—Borsa bazında dağılım.
data.oi.by_exchange[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
data.oi.by_exchange[].oi_usdnumberUSDUSD nominal değeri cinsinden açık pozisyon.
data.oi.n_exchangesnumber—Katkıda bulunan borsa sayısı.
data.oi.asofnumbermsKullanılan en yeni verinin zamanı.
data.oi.chg_basisobject—`oi_chg_pct` değerinin girdileri: eşleştirilmiş güncel ve önceki toplamlar (`cur`, `prev`), eşleşen borsa sayısı, referans saat ve hariç tutulan donmuş sözleşmeler.
data.oi.chg_basis.curnumber—Güncel değer.
data.oi.chg_basis.prevnumber—Önceki değer (referans).
data.oi.chg_basis.n_matchednumber—Karşılaştırmanın her iki ucunda da bulunan öğeler.
data.oi.chg_basis.prev_hour_tsnumbermsÖnceki saatlik dilimin başlangıcı.
data.oi.chg_basis.frozen_excludedobject—Kaynak değer değişmediği için hariç tutulan satırlar.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Referans anlık görüntüdeki öğeler.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Güncel anlık görüntüdeki öğeler.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDGüncel değer.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDReferans değer.
data.futures_volobject—Vadeli işlem hacmi.
data.futures_vol.total_usdnumberUSDToplam.
data.futures_vol.n_exchangesnumber—Katkıda bulunan borsa sayısı.
data.futures_vol.chg_basisobject—`futures_vol_chg_pct` değerinin girdileri: eşleştirilmiş güncel ve önceki hacim toplamları (`cur`, `prev`), eşleşen borsa sayısı ve referans saat.
data.futures_vol.chg_basis.curnumber—Güncel değer.
data.futures_vol.chg_basis.prevnumber—Önceki değer (referans).
data.futures_vol.chg_basis.n_matchednumber—Karşılaştırmanın her iki ucunda da bulunan öğeler.
data.futures_vol.chg_basis.prev_hour_tsnumbermsÖnceki saatlik dilimin başlangıcı.
data.fundingnumber—Fonlama oranı bloğu veya değeri.
data.funding_detailobject—`funding` değerinin ardındaki dağılım: 8h'ye normalize edilmiş basit ve açık pozisyon ağırlıklı oranlar, yıllıklandırılmış oran, borsa sayıları ve borsa başına bir kayıt.
data.funding_detail.basisstring—Vadeli fiyat eksi spot fiyat ya da baz bloğu.
data.funding_detail.avg_8hnumber—8h'ye normalize edilmiş oranların ortalaması.
data.funding_detail.oi_weighted_8hnumber—8h'ye normalize edilmiş oranların açık pozisyon ağırlıklı ortalaması.
data.funding_detail.apr_pctnumber% per yearYıllıklandırılmış yüzde.
data.funding_detail.n_exchangesnumber—Katkıda bulunan borsa sayısı.
data.funding_detail.n_normalizednumber—8h'ye normalize edilen borsalar.
data.funding_detail.n_unknown_intervalnumber—Fonlama aralığı bilinmeyen borsalar.
data.funding_detail.by_exchangearray—Borsa bazında dağılım.
data.funding_detail.by_exchange[]object—Borsa bazında dağılım.
data.funding_detail.by_exchange[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
data.funding_detail.by_exchange[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Oran.
data.funding_detail.by_exchange[].interval_hnumberhAralık.
data.funding_detail.by_exchange[].rate_8hnumber—8 saatlik döneme normalize edilmiş oran.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsZaman damgası.
data.long_shortobject—Long/short bloğu.
data.long_short.longnumber—Long tarafın değeri.
data.long_short.shortnumber—Short tarafın değeri.
data.long_short.rationumber—Oran.
data.long_short.typestring—Tür.
data.long_short.n_exchangesnumber—Katkıda bulunan borsa sayısı.
data.derivedobject—Coin için düzenli aralıklarla yeniden hesaplanan göstergeler (RSI, baz, toplu açık pozisyon, ortalama fonlama, long/short payları, 24h likidasyonlar); hesaplanmamışsa null.
data.derived.rsi_1hstring(decimal)—1h mumlarda RSI(14).
data.derived.rsi_4hstring(decimal)—4h mumlarda RSI(14).
data.derived.rsi_1dstring(decimal)—Günlük mumlarda RSI(14).
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearVade sonuna kalan gün sayısına göre yıllıklandırılmış baz.
data.derived.oi_usd_aggstring(decimal)USDSon gösterge yenilemesi anında tüm borsalar ve sözleşme türleri genelindeki toplu açık pozisyon; `oi.total_usd` değerinin biraz gerisinde kalabilir.
data.derived.funding_avgstring(decimal)—Borsalar genelinde ortalama fonlama oranı.
data.derived.ls_accountstring(decimal)—Hesap bazında long/short oranı.
data.derived.ls_takerstring(decimal)|null—Taker alış/satış oranı.
data.derived.liq_24h_usdstring(decimal)USD24h likidasyonlar.
data.liquidationobject—Likidasyon bloğu. dinamik anahtarlar: 1h,4h,12h,24h
data.liquidation.{*}object—Likidasyon bloğu.
data.liquidation.{*}.winstring—Kaydın pencere etiketi; anahtarını yineler (`1h`, `4h`, `12h` veya `24h`).
data.liquidation.{*}.long_usdnumberUSDLong taraf.
data.liquidation.{*}.short_usdnumberUSDShort taraf.
data.liquidation.{*}.total_usdnumberUSDToplam.
data.liquidation.{*}.cntnumber—Adet.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 4 gerçek yanıt.

Örnek yanıt

/api/currency/overview?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:31 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data.liquidation: 4 öğe içeriyordu; data.oi.by_exchange: 22 öğe içeriyordu; data.funding_detail.by_exchange: 23 öğe içeriyordu.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

Doğrulanmış örnekler

Yoklama, yukarıdaki örneğin yanı sıra bu uç noktayı aşağıdaki parametrelerle de çağırır ve her seferinde şemayı kontrol eder.

ParametrelerHTTPYanıt süresiSonuç
coin=ETH20086 msBaşarılı
coin=SOL20081 msBaşarılı
coin=ARKM20079 msBaşarılı

Kontrol: 2026-11-13 03:57:31 UTC

Ayrıntılar

Kimlik doğrulama
Yok. Herkese açık uç nokta.
İstek sınırı
IP başına dakikada 1200 istek
Sunucu önbelleği
30s
Edge mikro önbelleği
10s
Güncelleme sıklığı
üçüncü taraf piyasa verisi agregatörü 10 dakikada bir; ticker'lar dakikada bir; OI/fonlama/long-short 5 dakikada bir (ana coinler dakikada bir); spot hacim 10 dakikada bir; bellek içi önbellek 30 s
Pencere
hacim/likidasyonlar için kayan 24h; OI/fonlama/long-short için en güncel anlık görüntü
Veri kaynakları
Arz, piyasa değeri ve sıra üçüncü taraf piyasa verisi agregatöründen gelir; fiyat, açık pozisyon, fonlama, long/short, vadeli ve spot hacim borsaların herkese açık API'lerinden kurum içinde toplanır; likidasyonlar borsaların likidasyon akışlarından alınır.
Borsa kapsamı
Üçüncü taraf piyasa verisi agregatörüne dayanan tabloda yer alan ya da listelenmiş bir türev sözleşmesi bulunan her coin
Sayfalama
yok
Birimler
USD; rates as decimals; changes in percent
Yöntem
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

KullanılabilirKontrol: 2026-11-13 03:57:31 UTCHTTP 20095 msŞema eşleşiyorEn yeni veri noktası 20s öncesine ait

Erişilebilirlik, son 30 gün

411 kontrolde başarı oranı: %99.76

Hatalar

Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir.Değiştirmeden yeniden denemeyin; isteği düzeltin.
UNAUTHORIZED401`CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın.Değiştirmeden yeniden denemeyin.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir.`Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin.
INTERNAL500Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin.Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin.
UPSTREAM_FAILED503Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez.Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin.
UNAVAILABLE501 / 503Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok.Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler.
REQUEST_FAILED200Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin.Mesaja bağlıdır; başarısız bir istek olarak ele alın.

Deneyin

GET/api/currency/overviewKullanılabilir
Parametreler

string — Base coin symbol (uppercase, e.g. BTC).

İstek URL'sihttps://www.coinboss.com/api/currency/overview?coin=BTC
Bir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.