/api/currency/performance
GETKullanılabilir

Dönemlere göre coin fiyat performansı

Dönemlere göre coin fiyat performansı

GET/api/currency/performance

İ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/performance?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.pricenumber—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
data.perfobject—Coinin çeşitli geriye dönük pencerelerdeki fiyat değişimi; her biri en son 1h kapanışının pencere başlangıcındaki kapanışa göre değişimi olarak hesaplanır.
data.perf.4hnumber%4 saat önceki 1h mum kapanışına göre fiyat değişimi.
data.perf.24hnumber%24 saat önceki 1h mum kapanışına göre fiyat değişimi.
data.perf.7dnumber%7 gün önceki 1h mum kapanışına göre fiyat değişimi.
data.perf.30dnumber%30 gün önceki günlük kapanışa göre fiyat değişimi.
data.perf.90dnumber%90 gün önceki günlük kapanışa göre fiyat değişimi.
data.perf.180dnumber%180 gün önceki günlük kapanışa göre fiyat değişimi.
data.perf.1ynumber%365 gün önceki günlük kapanışa göre fiyat değişimi.
data.perf.ytdnumber%İçinde bulunulan yılın 1 Ocak (UTC) tarihindeki ya da ondan önceki son günlük kapanışa göre fiyat değişimi.
data.perf.allnumber%CoinBoss'un coin için elinde tuttuğu en eski günlük kapanışa (`all_start_price`) göre fiyat değişimi; coinin listelenme fiyatına göre değildir.
data.all_start_tsnumbermsZaman damgası.
data.all_start_pricenumberUSDMevcut en eski günlük mumun kapanışı; `perf.all` değerinin referansıdır. Zamanı `all_start_ts` alanındadır.

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

Örnek yanıt

/api/currency/performance?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:31 UTC.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "price": 68700.4,
      • "perf": { … 9 },
      • "all_start_ts": 1502928000000,
      • "all_start_price": 4285.08
      }
    }

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=ETH20015 msBaşarılı
coin=SOL20012 msBaşarılı
coin=ARKM20012 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
5m
Edge mikro önbelleği
10s
Güncelleme sıklığı
ilk 40 coin 5 dakikada bir, geri kalanlar sürekli dönüşümlü olarak; bellek içi önbellek 300 s
Pencere
4h, 24h, 7d (1h mumlar); 30d, 90d, 180d, 1y, YTD, all (1d mumlar)
Veri kaynakları
Binance vadeli mumlarından (yedek olarak OKX) kurum içinde hesaplanan dönem getirileri; daha eski BTC/ETH geçmişi Binance'in herkese açık spot arşivinden geriye dönük doldurulmuştur.
Borsa kapsamı
Depomuzda mum verisi bulunan coinler (1h: son 90 gün, 1d: son 2 yıl; BTC/ETH için daha uzun)
Sayfalama
yok
Birimler
percent
Yöntem
pct = (last_close - close_at_window_start) / close_at_window_start * 100; "all" starts at the first candle available in our store, not the asset's inception
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 20016 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/currency/performanceKullanılabilir
Parametreler

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

İstek URL'sihttps://www.coinboss.com/api/currency/performance?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.