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

Aylık / çeyreklik / yıllık getiri matrisi

Aylık / çeyreklik / yıllık getiri matrisi (BTC / ETH)

GET/api/p3/btc-returns

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringİsteğe bağlıBTCBTC, ETHCoin; yalnızca BTC veya ETH, diğerleri BTC sayılır. Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/p3/btc-returns?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.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
coinstring—Coin sembolü, büyük harfle (örneğin BTC).
matrixobject—Satır ve sütuna göre anahtarlanan matris. dinamik anahtarlar: 2013,2014,2015,2016,2017,2018
matrix.{*}object—Satır ve sütuna göre anahtarlanan matris. dinamik anahtarlar: 1,2,3,4,5,6
matrix.{*}.{*}number—Satır ve sütuna göre anahtarlanan matris.
monthAvgobject—Her takvim ayının, `matrix` içindeki tüm yıllar üzerinden ortalama aylık getirisi; anahtarlar `1`–`12` ay numaralarıdır. dinamik anahtarlar: 1,2,3,4,5,6
monthAvg.{*}number%O takvim ayının getirilerinin, verisi olan tüm yıllar üzerinden aritmetik ortalaması; anahtar ay numarasıdır.
monthMedobject—Her takvim ayının, tüm yıllar üzerinden medyan aylık getirisi; anahtarlar `1`–`12` ay numaralarıdır. dinamik anahtarlar: 1,2,3,4,5,6
monthMed.{*}number%O takvim ayının getirilerinin, verisi olan tüm yıllar üzerinden medyanı; anahtar ay numarasıdır.
qmatrixobject—Yıllara göre çeyreklik getiriler; anahtarlar takvim yıllarıdır. dinamik anahtarlar: 2013,2014,2015,2016,2017,2018
qmatrix.{*}object—Bir yılın çeyreklerinin getirileri; anahtarlar `1`–`4` çeyrek numaralarıdır, verisi olmayan çeyrekler atlanır. dinamik anahtarlar: 1,2,3,4
qmatrix.{*}.{*}number%Çeyreğin getirisi; o çeyrekte mevcut olan aylık getirilerin bileşiğiyle hesaplanır (içinde bulunulan çeyrek kısmidir).
qAvgobject—Her çeyreğin tüm yıllar üzerinden ortalama getirisi; anahtarlar `1`–`4` çeyrek numaralarıdır. dinamik anahtarlar: 1,2,3,4
qAvg.{*}number%O çeyreğin getirilerinin, verisi olan tüm yıllar üzerinden aritmetik ortalaması.
qMedobject—Her çeyreğin tüm yıllar üzerinden medyan getirisi; anahtarlar `1`–`4` çeyrek numaralarıdır. dinamik anahtarlar: 1,2,3,4
qMed.{*}number%O çeyreğin getirilerinin, verisi olan tüm yıllar üzerinden medyanı.
yearlyobject—Yıllık değerler. dinamik anahtarlar: 2013,2014,2015,2016,2017,2018
yearly.{*}number—Yıllık değerler.
yearSrcobject—Her yıl için kullanılan aylık mumların kaynağı; anahtarlar takvim yıllarıdır. dinamik anahtarlar: 2013,2014,2015,2016,2017,2018
yearSrc.{*}string—O yılın aylık mumlarının kaynak etiketi: `binance`, Binance'in çifti listelemesinden önceki yıllar için üçüncü taraf bir referans fiyat etiketi ya da `mixed`.

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

Örnek yanıt

/api/p3/btc-returns?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:33 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: qAvg: 4 öğe içeriyordu; qMed: 4 öğe içeriyordu; matrix: 14 öğe içeriyordu; yearly: 14 öğe içeriyordu; qmatrix: 14 öğe içeriyordu; yearSrc: 14 öğe içeriyordu.

  • {
    • "success": true,
    • "now": 1794542253311,
    • "coin": "BTC",
    • "matrix": {
      • "2013": { … 2 },
      • "2014": { … 2 }
      },
    • "monthAvg": {
      • "1": 3.3,
      • "2": 10.27
      },
    • "monthMed": {
      • "1": -1.09,
      • "2": 11.63
      },
    • "qmatrix": {
      • "2013": { … 2 },
      • "2014": { … 2 }
      },
    • "qAvg": {
      • "1": 47.83,
      • "2": 23.04
      },
    • "qMed": {
      • "1": -3,
      • "2": 9.21
      },
    • "yearly": {
      • "2013": 5372.48,
      • "2014": -57.38
      },
    • "yearSrc": {
      • "2013": "coinmetrics",
      • "2014": "coinmetrics"
      }
    }

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
10m
Edge mikro önbelleği
10s
Güncelleme sıklığı
6 saatte bir (içinde bulunulan ay yerinde güncellenir)
Pencere
tam aylık geçmiş
Veri kaynakları
Herkese açık bir referans fiyat veri kümesinden (ilk yıllar) ve borsaların aylık mum verilerinden kurum içinde hesaplanan aylık, çeyreklik ve yıllık getiriler.
Borsa kapsamı
BTC ve ETH.
Sıralama
yıl, artan
Birimler
percent
Yöntem
Monthly return = (close - open) / open x 100; quarterly and yearly returns compound the monthly ones; averages and medians per calendar month/quarter.
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:33 UTCHTTP 2003 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/p3/btc-returnsKullanılabilir
Parametreler

string · varsayılan BTC — Coin; BTC or ETH only, others treated as BTC.

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