/api/home/macro-cards
GETTersediaBeta

Kartu makro beranda

Kartu makro beranda (indeks saham, dolar, emas, ...)

GET/api/home/macro-cards

Permintaan

Endpoint ini tidak menerima parameter.

Contoh permintaan

curl -s "https://www.coinboss.com/api/home/macro-cards"

Kolom respons

Tabel kolom dihasilkan dari respons nyata, sehingga memuat persis apa yang dikembalikan endpoint. Path memakai a[] untuk item array dan {*} untuk objek yang kuncinya berupa nama dinamis seperti koin atau bursa.

KolomTipeSatuanDeskripsi
successboolean—true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`.
updated_atnumbermsWaktu baris ini terakhir diperbarui.
mcapobject—Kapitalisasi pasar.
mcap.latestnumber—Catatan terbaru.
mcap.datestring—Tanggal kalender (UTC).
mcap.chg24h_pctnumber%Perubahan persentase 24h.
mcap.sparkarray—Deret pendek terkini untuk sparkline.
mcap.spark[]number—Deret pendek terkini untuk sparkline.
mcap.has_cmcboolean—true jika ada titik `spark` yang berasal dari riwayat pihak ketiga yang diisi mundur, bukan dari snapshot harian milik situs sendiri.
volumeobject—Volume.
volume.futuresnumber—Blok atau nilai pasar futures.
volume.spotnumber—Blok atau nilai pasar spot.
volume.tsnumbermsStempel waktu.
volume.sparkarray—Deret pendek terkini untuk sparkline.
volume.spark[]object—Deret pendek terkini untuk sparkline.
volume.spark[].tnumbermsStempel waktu.
volume.spark[].fnumberUSDRata-rata pembacaan volume futures 24h di dalam bucket 3 jam tersebut.
volume.spark[].snumberUSDRata-rata pembacaan volume spot 24h di dalam bucket 3 jam tersebut.
btc_candlesarray—Candlestick BTC untuk overlay.
btc_candles[]array—Candlestick BTC untuk overlay.
btc_candles[][]number—Candlestick BTC untuk overlay.
fngobject—Kartu Fear & Greed: `value` terbaru, labelnya `cls`, dan `spark` berisi nilai harian terkini; null jika tidak ada data.
fng.valuenumber—Nilai.
fng.clsstring—Label teks nilai Fear & Greed terbaru, misalnya `Fear` atau `Greed`.
fng.sparkarray—Deret pendek terkini untuk sparkline.
fng.spark[]number—Deret pendek terkini untuk sparkline.
stablecoinobject—Kartu stablecoin: total nilai beredar dalam USD (`total`), jumlah stablecoin (`count`), serta perubahan 24h dan 7d-nya.
stablecoin.totalnumber—Total.
stablecoin.countnumber—Jumlah item.
stablecoin.chg24h_pctnumber%Perubahan persentase 24h.
stablecoin.chg7d_pctnumber%Perubahan persentase 7 hari.
liqobject—Nilai atau blok likuidasi.
liq.totalnumber—Total.
liq.longnumber—Nilai sisi long.
liq.shortnumber—Nilai sisi short.
liq.chg24h_pctnumber%Perubahan persentase 24h.
liq.sparkarray—Deret pendek terkini untuk sparkline.
liq.spark[]number—Deret pendek terkini untuk sparkline.

Dihasilkan 2026-11-11 23:01 UTC dari 1 respons nyata.

Contoh respons

/api/home/macro-cards · Respons nyata yang direkam 2026-11-13 04:03:40 UTC. Array dan map yang panjang dipersingkat untuk tampilan: fng.spark berisi 30 item; liq.spark berisi 57 item; mcap.spark berisi 90 item; btc_candles berisi 42 item; volume.spark berisi 57 item.

  • {
    • "success": true,
    • "updated_at": 1794542517577,
    • "mcap": {
      • "latest": 2476085584564.88,
      • "date": "2026-11-13",
      • "chg24h_pct": -3.19,
      • "spark": [ … 8 ],
      • "has_cmc": false
      },
    • "volume": {
      • "futures": 216570771117.84,
      • "spot": 66073226871.26,
      • "ts": 1794541800000,
      • "spark": [ … 2 ]
      },
    • "btc_candles": [
      • [ … 5 ],
      • [ … 5 ]
      ],
    • "fng": {
      • "value": 20,
      • "cls": "Extreme Fear",
      • "spark": [ … 8 ]
      },
    • "stablecoin": {
      • "total": 288099833329.21,
      • "count": 353,
      • "chg24h_pct": -0.53,
      • "chg7d_pct": -1.71
      },
    • "liq": {
      • "total": 1363652914.6799948,
      • "long": 1267678685.9899955,
      • "short": 95974228.69,
      • "chg24h_pct": 501.84,
      • "spark": [ … 8 ]
      }
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
2m
Mikro-cache edge
10s
Frekuensi pembaruan
kapitalisasi pasar harian; volume setiap 10 min; candlestick setiap 5 min; Fear & Greed harian; stablecoin setiap 10 min; cache API 120 s
Jendela
kapitalisasi pasar 90 hari; volume 7 hari; candlestick 4h BTC; Fear & Greed 30 hari; likuidasi 24h
Sumber data
Kartu makro halaman beranda: total kapitalisasi pasar (snapshot harian kapitalisasi pasar dari agregator data pasar pihak ketiga), volume futures dan likuidasi (data bursa), candlestick BTC (Binance), Fear & Greed (alternative.me), dan suplai stablecoin (sumber pihak ketiga).
Cakupan bursa
Seluruh pasar
Paginasi
tidak ada
Satuan
USD; changes in percent; Fear & Greed 0-100
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Beta

Status langsung

TersediaDiperiksa 2026-11-13 04:03:40 UTCHTTP 2001 msSkema sesuaiTitik data terbaru berusia 2m

Ketersediaan, 30 hari terakhir

100% dari 409 pemeriksaan lolos

Error

Panggilan yang gagal memiliki satu bentuk yang sama di semua endpoint. Daftar lengkapnya ada di halaman error. Error dan batas permintaan →

KodeHTTPArtiTindakan
INVALID_PARAM400Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui.Jangan mengulang tanpa perubahan; perbaiki permintaannya.
UNAUTHORIZED401Header `CB-API-KEY` dikirim tetapi kuncinya tidak dikenal atau sudah dicabut. Data publik tidak memerlukan kunci — hapus header tersebut atau gunakan kunci yang valid.Jangan mengulang tanpa perubahan.
FORBIDDEN403Rute ini bukan bagian dari API publik (internal atau khusus akun).Jangan mengulang.
NOT_FOUND404Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada.Jangan mengulang; periksa path dan pengenal terhadap katalog.
RATE_LIMITED429Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu.Tunggu selama `Retry-After`, lalu ulangi dengan backoff.
INTERNAL500Error server yang tidak terduga. Pesannya sengaja dibuat generik; sertakan `request_id` saat melaporkannya.Ulangi sekali setelah beberapa detik; laporkan beserta ID permintaan jika masih terjadi.
UPSTREAM_FAILED503Sumber data di balik endpoint ini tidak menjawab tepat waktu. Tidak ada angka usang atau angka pengganti yang dikembalikan sebagai gantinya.Ulangi dengan backoff; periksa halaman status.
UNAVAILABLE501 / 503Dataset untuk sementara belum siap (cache sedang diisi) atau endpoint belum memiliki sumber publik yang sah.Ulangi nanti; katalog menandai endpoint yang memang tidak tersedia secara desain.
REQUEST_FAILED200Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP.Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal.

Coba

GET/api/home/macro-cardsTersedia
Parameter

Tidak ada parameter.

URL permintaanhttps://www.coinboss.com/api/home/macro-cards
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.