/api/spot/coins
GETKullanılabilir

Spot coin piyasa listesi

Spot coin piyasa listesi (fiyat, değişim, hacim, piyasa değeri; sayfalı)

GET/api/spot/coins

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
limitintegerİsteğe bağlı50≤ 200Döndürülecek satır sayısı. Örnek: 50
offsetintegerİsteğe bağlı0—Sayfalama ofseti.
langstringİsteğe bağlı—zh, zh-TW, zh-twDil (zh / zh-TW yerelleştirilmiş adları döndürür, diğerleri İngilizce).

Örnek istek

curl -s "https://www.coinboss.com/api/spot/coins?limit=50"

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.
totalnumber—Toplam.
offsetnumber—Uygulanan satır ofseti.
limitnumber—Uygulanan satır sınırı.
dataarray—Veri yükü.
data[]object—Veri yükü.
data[].coinstring—Coin sembolü, büyük harfle (örneğin BTC).
data[].image_urlstring—CoinBoss'un sunduğu aynı kaynaklı (same-origin) simge yolu; doğrulanmış simge yoksa null.
data[].pricenumber—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
data[].change_1hnumber—1h değişim.
data[].change_24hnumber—24h değişim.
data[].change_7dnumber—7 günlük değişim.
data[].market_capnumber—Piyasa değeri.
data[].volume_24hnumber—24h hacim.
data[].vol_chg_24h_pctnumber|null%Hacmin 24h değişimi.
data[].net_1hnumber|nullUSDCoinin son bir saatteki Binance spot taker alış hacmi eksi taker satış hacmi; coinin akış verisi yoksa null.
data[].net_4hnumber|nullUSDCoinin son 4 saatteki Binance spot taker alış hacmi eksi taker satış hacmi; coinin akış verisi yoksa null.
data[].net_24hnumber|nullUSDCoinin son 24 saatteki Binance spot taker alış hacmi eksi taker satış hacmi; coinin akış verisi yoksa null.
data[].ranknumber—Bu listedeki sıra (1 = ilk).

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

Örnek yanıt

/api/spot/coins?limit=50 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:34 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 50 öğe içeriyordu.

  • {
    • "success": true,
    • "total": 2479,
    • "offset": 0,
    • "limit": 50,
    • "data": [
      • { … 13 },
      • { … 13 }
      ]
    }

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ünden ilk 1000 coin 10 dakikada bir (sıralama dışındaki coinler saatlik yeniden sorgulanır); net akış 5 dakikada bir; hacim anlık görüntüleri saatlik; API önbelleği 30 s
Pencere
net_1h / net_4h / net_24h kayan pencere; vol_chg_24h_pct = en güncel saatlik anlık görüntü ile 24h önceki anlık görüntünün karşılaştırması (3h boşluk toleransı)
Veri kaynakları
Fiyat, piyasa değeri, 24h hacim ve 1h/24h/7d değişim üçüncü taraf piyasa verisi agregatöründen gelir; spot net girişi Binance'in 1 dakikalık taker alış/satış hacminden türetilir; 24h hacim değişimi, borsalar arası saatlik vadeli hacim anlık görüntülerinden kurum içinde hesaplanır.
Borsa kapsamı
Üçüncü taraf piyasa verisi agregatörüne dayanan tabloda fiyatı > 0 olan tüm coinler (yaklaşık 2.470); net akış yalnızca Binance spot piyasasında izlenen yaklaşık 50 ana coin için vardır (diğerleri null)
Sayfalama
limit (varsayılan 50, en çok 200) + offset; total döndürülür
Sıralama
market_cap, azalan (piyasa değeri olmayan satırlar sonda)
Birimler
USD; change fields in percent
Yöntem
net_Xh = SUM(taker_buy_usd - taker_sell_usd) over window; vol_chg_24h_pct = (vol_now - vol_24h_ago) / vol_24h_ago * 100; rank = offset + row index + 1
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:34 UTCHTTP 200105 msŞema eşleşiyor

Erişilebilirlik, son 30 gün

411 kontrolde başarı oranı: %100

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/spot/coinsKullanılabilir
Parametreler

integer · varsayılan 50 · en çok 200 — Number of rows to return.

integer · varsayılan 0 — Pagination offset.

string — Locale (zh / zh-TW return localized names, otherwise English).

İstek URL'sihttps://www.coinboss.com/api/spot/coins?limit=50
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.