Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/sd/basis/rank
GETTerdegradasiSTALE

Peringkat koin berdasarkan basis

Peringkat koin berdasarkan basis median lintas bursa, dengan rata-rata, basis berbobot OI, open interest, serta bursa dengan nilai terendah dan tertinggi.

GET/api/sd/basis/rank
Terdegradasi. Endpoint melaporkan kualitas data STALE

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
kindstringOpsionalperpperp, spot_perp`perp`: harga mark terhadap harga indeks bursa yang sama. `spot_perp`: harga perpetual terhadap harga spot bursa yang sama.
sortstringOpsionalbasis_descbasis_desc, basis_asc, abs_descKunci pengurutan: median basis tertinggi, terendah, atau terbesar secara absolut lebih dulu.
limitintegerOpsional50≥ 1 · ≤ 200Jumlah baris.
min_exchangesintegerOpsional3≥ 1 · ≤ 20Hanya koin yang memiliki basis di minimal sejumlah bursa ini.

Contoh permintaan

curl -s "https://www.coinboss.com/api/sd/basis/rank"

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 }`.
schemastring—ID skema respons ini. ID hanya berubah jika kolom yang sudah ada berubah makna atau tipe.
nownumbermsWaktu server saat respons disusun.
kindstring—`perp` atau `spot_perp`.
sortstring—Urutan yang diterapkan.
limitnumber—Batas baris yang diterapkan.
min_exchangesnumber—Jumlah bursa minimum yang diterapkan.
totalnumber—Baris yang tersedia sebelum `limit` diterapkan.
countnumber—Baris yang dikembalikan.
dataarray—Satu baris per koin.
data[]object—Satu baris per koin.
data[].ranknumber—Posisi dalam peringkat; `null` jika baris tidak memiliki nilai untuk diperingkat.
data[].coinstring—Simbol koin (huruf besar).
data[].basis_pctnumber%(mark − index) ÷ index × 100 untuk kontrak perpetual dan kontrak berjangka; pada peringkat, median lintas bursa.
data[].mean_pctnumber%Rata-rata sederhana atas himpunan yang sama dengan median.
data[].oi_weighted_pctnumber%Basis berbobot open interest; baris tanpa bobot OI tidak dimasukkan.
data[].oi_usdnumberUSDOpen interest kontrak, satu sisi; dipakai sebagai bobot.
data[].n_exchangesnumber—Bursa dalam agregat.
data[].n_contractsnumber—Kontrak dalam agregat.
data[].minobject—Bursa dan kontrak dengan basis terendah.
data[].min.exchangestring—ID bursa (huruf kecil).
data[].min.symbolstring—Simbol kontrak dalam bentuk penyimpanan CoinBoss.
data[].min.basis_pctnumber%(mark − index) ÷ index × 100 untuk kontrak perpetual dan kontrak berjangka; pada peringkat, median lintas bursa.
data[].maxobject—Bursa dan kontrak dengan basis tertinggi.
data[].max.exchangestring—ID bursa (huruf kecil).
data[].max.symbolstring—Simbol kontrak dalam bentuk penyimpanan CoinBoss.
data[].max.basis_pctnumber%(mark − index) ÷ index × 100 untuk kontrak perpetual dan kontrak berjangka; pada peringkat, median lintas bursa.
coverageobject—Apa yang termasuk dan tidak termasuk dalam angka-angka ini. Bandingkan ini terlebih dahulu sebelum membandingkan total dengan sumber lain.
coverage.included_exchangesarray—Sumber yang data segarnya disertakan.
coverage.included_exchanges[]string—Sumber yang data segarnya disertakan.
coverage.unavailablearray—Sumber yang tidak dapat disertakan, masing-masing dengan alasannya. Sumber tersebut tidak pernah dihitung sebagai 0.
coverage.unavailable[]object—Sumber yang tidak dapat disertakan, masing-masing dengan alasannya. Sumber tersebut tidak pernah dihitung sebagai 0.
coverage.unavailable[].exchangestring—ID bursa (huruf kecil).
coverage.unavailable[].reasonstring—Kode alasan yang dapat dibaca mesin.
coverage.unavailable[].detailstring—Penjelasan alasan yang dapat dibaca manusia.
coverage.stale_excludedarray—Baris yang tidak dimasukkan karena pembaruan terakhirnya berada di luar jendela kesegaran. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
methodobject—Pernyataan teks biasa tentang rumus yang dipakai untuk respons ini, satu entri per kolom.
method.basis_pctstring—Catatan rumus untuk `basis_pct`, teks biasa.
method.oi_weighted_pctstring—Catatan rumus untuk `oi_weighted_pct`, teks biasa.
method.inclusionstring—Catatan rumus untuk `inclusion`, teks biasa.
method.coinstring—Catatan rumus untuk `coin`, teks biasa.
metaobject—Silsilah data dan kesegaran respons ini.
meta.schemastring—ID skema respons ini. ID hanya berubah jika kolom yang sudah ada berubah makna atau tipe.
meta.sourcearray—Endpoint publik hulu tempat data dikumpulkan.
meta.source[]object—Endpoint publik hulu tempat data dikumpulkan.
meta.source[].exchangestring—ID bursa (huruf kecil).
meta.source[].endpointstring—Endpoint publik sumber yang dibaca kolektor (ditampilkan sebagai silsilah data; klien tidak pernah memanggilnya).
meta.observed_atnumbermsStempel waktu yang diberikan sumber untuk data tersebut.
meta.received_atnumbermsWaktu kolektor CoinBoss menerima data.
meta.fetched_atnumbermsWaktu respons ini disusun.
meta.windowstring—Jendela waktu yang dicakup angka-angka ini.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN, atau UNAVAILABLE, dinilai dari stempel waktu data dan cakupan.
meta.is_staleboolean—True jika data lebih lama dari jendela kesegarannya.
meta.cache_ttl_snumbersMasa hidup cache respons ini.
meta.fallbackstring—Apa yang dikembalikan endpoint ketika kolektor atau sumber gagal.
meta.collector_heartbeat_age_snumbersJumlah detik sejak kolektor terakhir melaporkan bahwa ia berjalan.

Dihasilkan 2026-11-11 23:00 UTC dari 3 respons nyata.

Contoh respons

/api/sd/basis/rank · Respons nyata yang direkam 2026-11-13 03:58:08 UTC. Array dan map yang panjang dipersingkat untuk tampilan: coverage.stale_excluded berisi 21 item.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794542288498,
    • "kind": "perp",
    • "sort": "basis_desc",
    • "limit": 50,
    • "min_exchanges": 3,
    • "total": null,
    • "count": null,
    • "data": null,
    • "coverage": {
      • "included_exchanges": [],
      • "unavailable": [],
      • "stale_excluded": [ … 2 ]
      },
    • "method": {
      • "basis_pct": "median over exchanges (one primary contract per exchange) of the perpetual mark-vs-index basis, percent; the ranking key",
      • "oi_weighted_pct": "OI-weighted mean over all included contracts of the coin (single-sided OI, <= 3 h old); null when no contract has a weight",
      • "inclusion": "fresh rows only (<= 180 s); same row filters as /api/sd/basis; catalogued stock/ETF perpetuals (stock_contracts) are removed; coins quoted on fewer than min_exc…",
      • "coin": "multiplier contracts are folded into the underlying coin (1000PEPE, kPEPE -> PEPE)"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [],
      • "observed_at": null,
      • "received_at": null,
      • "fetched_at": 1794542288498,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 30,
      • "fallback": "only rows refreshed within 180 s are ranked; when the collector is down the list is empty and quality is STALE",
      • "collector_heartbeat_age_s": 3091
      }
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
kind=spot_perp2002 msLolos STALE
sort=basis_asc&limit=102002 msLolos STALE
sort=zzz4002 msLolos mengembalikan error yang diharapkan

Diperiksa 2026-11-13 03:58:08 UTC

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
30s
Mikro-cache edge
10s
Frekuensi pembaruan
Putaran kolektor setiap 60 detik; sebuah baris dianggap segar selama 180 detik. Snapshot per jam mengisi riwayat.
Jendela
Nilai terbaru per kontrak.
Sumber data
Harga mark, harga indeks, dan harga terakhir yang dipublikasikan 21 bursa derivatif, ditambah harga spot bursa yang sama, dikumpulkan dan disimpan oleh CoinBoss (sd_px_latest, sd_px_hourly).
Cakupan bursa
21 bursa. Bursa yang tidak memublikasikan harga indeks atau harga mark tercantum di `coverage.unavailable`; baris yang kedua sisi harganya terpaut lebih dari 60 detik mengembalikan `null`. Baris yang tidak dimasukkan ke agregat tercantum di `coverage.excluded_from_aggregate` beserta alasannya.
Paginasi
Tanpa paginasi; `limit` membatasi jumlah baris (maks 200).
Pengurutan
Dikendalikan oleh `sort`; kunci pengurutannya adalah median lintas bursa (`basis_pct`).
Satuan
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil
Tersedia sejak
2026-11-11

Status langsung

TerdegradasiDiperiksa 2026-11-13 03:58:08 UTCHTTP 20023 msSkema sesuai

Endpoint melaporkan kualitas data STALE

Ketersediaan, 30 hari terakhir

100% dari 407 pemeriksaan lolos

Pergeseran skema yang terdeteksi oleh probe terakhir
  • Dikembalikan tetapi tidak didokumentasikan: coverage.stale_excluded[], coverage.stale_excluded[].exchange, coverage.stale_excluded[].age_s

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/sd/basis/rankTerdegradasi
Parameter

string · default perp — `perp`: mark price against the index price of the same exchange. `spot_perp`: perpetual price against the spot price of the same exchange.

string · default basis_desc — Sort key: highest, lowest or largest absolute median basis first.

integer · default 50 · min 1 · maks 200 — Number of rows.

integer · default 3 · min 1 · maks 20 — Only coins with a basis on at least this many exchanges.

URL permintaanhttps://www.coinboss.com/api/sd/basis/rank
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.