Ana sayfa makro kartları
Ana sayfa makro kartları (hisse endeksleri, dolar, altın, ...)
/api/home/macro-cardsİstek
Bu uç nokta parametre almaz.
Örnek istek
curl -s "https://www.coinboss.com/api/home/macro-cards"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.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| updated_at | number | ms | Bu satırın en son güncellendiği zaman. |
| mcap | object | — | Piyasa değeri. |
| mcap.latest | number | — | En son kayıt. |
| mcap.date | string | — | Takvim tarihi (UTC). |
| mcap.chg24h_pct | number | % | 24h yüzde değişim. |
| mcap.spark | array | — | Mini grafikler (sparkline) için kısa güncel seri. |
| mcap.spark[] | number | — | Mini grafikler (sparkline) için kısa güncel seri. |
| mcap.has_cmc | boolean | — | `spark` noktalarından herhangi biri sitenin kendi günlük anlık görüntüleri yerine sonradan doldurulmuş üçüncü taraf geçmişinden geliyorsa true. |
| volume | object | — | Hacim. |
| volume.futures | number | — | Vadeli piyasa bloğu veya değeri. |
| volume.spot | number | — | Spot piyasa bloğu veya değeri. |
| volume.ts | number | ms | Zaman damgası. |
| volume.spark | array | — | Mini grafikler (sparkline) için kısa güncel seri. |
| volume.spark[] | object | — | Mini grafikler (sparkline) için kısa güncel seri. |
| volume.spark[].t | number | ms | Zaman damgası. |
| volume.spark[].f | number | USD | O 3 saatlik dilimdeki 24h vadeli hacim okumalarının ortalaması. |
| volume.spark[].s | number | USD | O 3 saatlik dilimdeki 24h spot hacim okumalarının ortalaması. |
| btc_candles | array | — | Üst üste bindirme için BTC mumları. |
| btc_candles[] | array | — | Üst üste bindirme için BTC mumları. |
| btc_candles[][] | number | — | Üst üste bindirme için BTC mumları. |
| fng | object | — | Korku ve Açgözlülük kartı: en güncel `value`, etiketi `cls` ve son günlük değerlerden oluşan `spark`; veri yoksa null. |
| fng.value | number | — | Değer. |
| fng.cls | string | — | En güncel Korku ve Açgözlülük değerinin metin etiketi; örneğin `Fear` veya `Greed`. |
| fng.spark | array | — | Mini grafikler (sparkline) için kısa güncel seri. |
| fng.spark[] | number | — | Mini grafikler (sparkline) için kısa güncel seri. |
| stablecoin | object | — | Stablecoin kartı: USD cinsinden dolaşımdaki toplam değer (`total`), stablecoin sayısı (`count`) ve bunun 24h ile 7d değişimi. |
| stablecoin.total | number | — | Toplam. |
| stablecoin.count | number | — | Öğe sayısı. |
| stablecoin.chg24h_pct | number | % | 24h yüzde değişim. |
| stablecoin.chg7d_pct | number | % | 7 günlük yüzde değişim. |
| liq | object | — | Likidasyon değeri veya bloğu. |
| liq.total | number | — | Toplam. |
| liq.long | number | — | Long tarafın değeri. |
| liq.short | number | — | Short tarafın değeri. |
| liq.chg24h_pct | number | % | 24h yüzde değişim. |
| liq.spark | array | — | Mini grafikler (sparkline) için kısa güncel seri. |
| liq.spark[] | number | — | Mini grafikler (sparkline) için kısa güncel seri. |
Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/home/macro-cards · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:59:25 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: fng.spark: 30 öğe içeriyordu; liq.spark: 57 öğe içeriyordu; mcap.spark: 90 öğe içeriyordu; btc_candles: 42 öğe içeriyordu; volume.spark: 57 öğe içeriyordu.
- "success"true
- "updated_at"1794542365066
- "mcap"
- "latest"2476085584564.88
- "date""2026-11-13"
- "chg24h_pct"-3.19
- "spark"
- "has_cmc"false
- "volume"
- "futures"216570771117.84
- "spot"66073226871.26
- "ts"1794541800000
- "spark"
- "btc_candles"
- "fng"
- "value"20
- "cls""Extreme Fear"
- "spark"
- "stablecoin"
- "total"288099833329.21
- "count"353
- "chg24h_pct"-0.53
- "chg7d_pct"-1.71
- "liq"
- "total"1363532410.6799946
- "long"1267567542.2399952
- "short"95964868.44
- "chg24h_pct"501.86
- "spark"
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
- 2m
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- piyasa değeri günlük; hacim 10 dakikada bir; mumlar 5 dakikada bir; Korku ve Açgözlülük günlük; stablecoinler 10 dakikada bir; API önbelleği 120 s
- Pencere
- piyasa değeri 90 gün; hacim 7 gün; BTC 4h mumları; Korku ve Açgözlülük 30 gün; likidasyonlar 24h
- Veri kaynakları
- Ana sayfa makro kartları: toplam piyasa değeri (üçüncü taraf piyasa verisi agregatörünün piyasa değerlerinin günlük anlık görüntüsü), vadeli işlem hacmi ve likidasyonlar (borsa verileri), BTC mumları (Binance), Korku ve Açgözlülük (alternative.me) ve stablecoin arzı (üçüncü taraf kaynak).
- Borsa kapsamı
- Piyasa geneli
- Sayfalama
- yok
- Birimler
- USD; changes in percent; Fear & Greed 0-100
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Beta
Canlı durum
Erişilebilirlik, son 30 gün
408 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ı →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu 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. |
| UNAUTHORIZED | 401 | `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. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika 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. |
| INTERNAL | 500 | Beklenmeyen 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_FAILED | 503 | Bu 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. |
| UNAVAILABLE | 501 / 503 | Veri 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_FAILED | 200 | Bazı 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
/api/home/macro-cardsKullanılabilirParametre yok.
https://www.coinboss.com/api/home/macro-cardsBu kategoride daha fazlası
- Küresel türev metrikleri /api/derivatives/global
- Ana sayfa gösterge kartları paketi /api/home/indicator-cards
- Ana sayfa makro kartları /api/home/macro-cards
- Aylık BTC spot hacmi /api/indicators/cm/btc-spot-vol-monthly
- Aylık kripto spot hacmi /api/indicators/cm/crypto-spot-vol-monthly
- Toplam kripto piyasa değeri ve başlıca coinlerin piyasa değeri geçmişi /api/indicators/marketcap
- Türe göre kripto piyasa değeri dağılımı /api/indicators/marketcap-type
- Ana sayfa ticker şeridi toplamları /api/market/home-ticker
- Türev piyasası özeti /api/market/overview
- Günlük sürekli vadeli / spot hacim oranı /api/p3/perp-spot-ratio
- Sürekli vadeli ve spot hacim karşılaştırması /api/p3/perp-spot-volume
- Piyasa geneli hacim zaman serisi /api/p3/volume/history
- Hacim özeti /api/p3/volume/overview
- Toplam stablecoin piyasa değeri geçmişi /api/stablecoins/chart
- Stablecoin listesi /api/stablecoins/list
- BTC dominansı geçmişi /api/volume/btc-dominance-series
- Küresel spot / türev hacim geçmişi /api/volume/global-history