Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/content/coin
GETTersediaBeta

Ringkasan agregat halaman koin

Ringkasan agregat halaman koin

GET/api/content/coin

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringWajib——Simbol koin dasar (huruf besar, mis. BTC). Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/content/coin?coin=BTC"

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 }`.
nownumbermsWaktu server saat respons disusun.
coinstring—Simbol koin, huruf besar (misalnya BTC).
oi_totalnumberUSDOpen interest koin yang dijumlahkan dari semua bursa dengan data segar; null jika tidak ada.
oi_toparray—Tiga bursa dengan open interest terbesar pada koin tersebut.
oi_top[]object—Satu bursa: `ex` (nama tampilan), `oi` (USD), dan `share_pct` (% dari `oi_total`).
oi_top[].exstring—ID bursa, huruf kecil.
oi_top[].oinumber—Open interest.
oi_top[].share_pctnumber%Pangsa dari total.
oi_exchangesnumbercountJumlah bursa dengan open interest segar untuk koin tersebut; null jika tidak ada.
listed_exchangesnumbercountJumlah bursa yang ticker futures-nya untuk koin tersebut diperdagangkan dan diperbarui dalam satu jam terakhir; null jika tidak ada.
vol24_perpnumberUSDVolume futures 24h koin yang dijumlahkan dari bursa-bursa tersebut; null jika tidak ada.
funding_weighted_pctnumber%Funding rate saat ini yang dinormalkan ke 8 jam dan dibobot dengan open interest lintas bursa, dalam persen; rata-rata sederhana jika tidak ada bobot.
funding_basisstring—Label metode di balik `funding_weighted_pct`; selalu `8h_normalized_oi_weighted`.
liq24object—Likuidasi koin dalam 24 jam terakhir: `total`, `long`, `short` dalam USD dan `cnt` (order); null jika tidak ada.
liq24.totalnumber—Total.
liq24.longnumber—Nilai sisi long.
liq24.shortnumber—Nilai sisi short.
liq24.cntnumber—Jumlah.
categoryobject—Kategori.
category.idstring—Pengenal.
category.namestring—Nama.
category.avg_chg_pctnumber%Rata-rata perubahan harga 24h dari koin-koin dalam kategori.
category.coin_cntnumbercountJumlah koin dalam kategori yang memiliki perubahan harga 24h.
category.coin_chg_pctnumber%Perubahan harga 24h koin ini sebagaimana tercatat dalam data kategori.

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

Contoh respons

/api/content/coin?coin=BTC · Respons nyata yang direkam 2026-11-13 03:59:31 UTC. Array dan map yang panjang dipersingkat untuk tampilan: oi_top berisi 3 item.

  • {
    • "success": true,
    • "now": 1794542371462,
    • "coin": "BTC",
    • "oi_total": 49044196375.55998,
    • "oi_top": [
      • { … 3 },
      • { … 3 }
      ],
    • "oi_exchanges": 22,
    • "listed_exchanges": 23,
    • "vol24_perp": 72105874257.34,
    • "funding_weighted_pct": 0.0057,
    • "funding_basis": "8h_normalized_oi_weighted",
    • "liq24": {
      • "total": 784893531.1899996,
      • "long": 773565333.2599992,
      • "short": 11328197.929999996,
      • "cnt": 29621
      },
    • "category": {
      • "id": "proof-of-work-pow",
      • "name": "Proof of Work (PoW)",
      • "avg_chg_pct": -0.99,
      • "coin_cnt": 125,
      • "coin_chg_pct": -0.45
      }
    }

Sampel terverifikasi

Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.

ParameterHTTPLatensiHasil
coin=ETH20035 msLolos
coin=SOL20045 msLolos
coin=ARKM20046 msLolos

Diperiksa 2026-11-13 03:59:31 UTC

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5m
Mikro-cache edge
10s
Frekuensi pembaruan
ticker setiap 1 min; OI/funding setiap 5 min; cache API 300 s
Jendela
24h
Sumber data
Angka ringkasan per koin (total OI dan bursa teratas, funding berbobot OI, volume perpetual 24h, likuidasi 24h) yang diagregasi sendiri dari data bursa, dengan perbandingan kategori dari agregator data pasar pihak ketiga.
Cakupan bursa
Koin apa pun yang memiliki kontrak derivatif tercatat
Paginasi
tidak ada
Satuan
USD; funding_weighted_pct in percent per 8h
Metode
funding_weighted_pct = OI-weighted mean of (rate * 8 / interval_hours) * 100; oi_total = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h)
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Beta

Status langsung

TersediaDiperiksa 2026-11-13 03:59:31 UTCHTTP 20057 msSkema sesuai

Ketersediaan, 30 hari terakhir

100% dari 408 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/content/coinTersedia
Parameter

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

URL permintaanhttps://www.coinboss.com/api/content/coin?coin=BTC
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.