Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/usdt-premium
GETTersedia

Premium OTC USDT terhadap kurs valas fiat

Premium OTC USDT terhadap kurs valas fiat

GET/api/usdt-premium

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
currencystringOpsionalUSDUSD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, … (16)Kode fiat; didahulukan daripada locale. Contoh: CNY
localestringOpsional—en, zh, zh-TW, ko, ja, es, fr, de, pt, it, ru, vi, tr, idLocale yang dipetakan ke fiat default (mis. zh→CNY).

Contoh permintaan

curl -s "https://www.coinboss.com/api/usdt-premium?currency=CNY"

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 }`.
currencystring—Simbol mata uang / aset.
methodstring—Catatan rumus / metode.
fx_histboolean—True jika riwayat kurs resmi harian telah diisi mundur untuk mata uang ini; false jika riwayat hanya terakumulasi dari pengumpulan langsung.
availableboolean—Apakah data tersedia.
currentobject—Nilai saat ini.
current.usdt_ratenumberfiat per USDTHarga pasar 1 USDT dalam mata uang fiat yang dipilih pada `ts`, dari agregator data pasar publik.
current.official_fxnumberfiat per USDKurs resmi pada `ts`: jumlah unit mata uang fiat yang dipilih per 1 USD (1 untuk USD).
current.premium_pctnumber%Premium terhadap harga acuan.
current.tsstring—String tanggal-waktu.
historyobject—Titik historis, dari yang terlama kecuali dinyatakan lain.
history.h7array—Titik mentah untuk 7 hari terakhir.
history.h7[]object—Titik mentah untuk 7 hari terakhir.
history.h7[].tstring—String tanggal-waktu.
history.h7[].vnumber—Nilai.
history.d30array—Satu titik per hari untuk 30 hari terakhir.
history.d30[]object—Satu titik per hari untuk 30 hari terakhir.
history.d30[].tstring—String tanggal-waktu.
history.d30[].vnumber—Nilai.
c2cobject—Premium yang sama, diukur dari penawaran USDT peer-to-peer (C2C), dipisahkan dari metode harga pasar; null untuk mata uang yang tidak didukung.
c2c.availableboolean—Apakah data tersedia.
c2c.switch_datestring—Tanggal UTC (YYYY-MM-DD) sampel C2C pertama yang dimiliki untuk mata uang ini; null jika tidak ada.
c2c.currentobject—Nilai saat ini.
c2c.current.c2c_pricenumberfiat per USDTHarga iklan terendah untuk membeli 1 USDT dengan mata uang fiat di platform P2P pada `source`, di antara iklan yang menerima ukuran order ambang.
c2c.current.official_fxnumberfiat per USDKurs resmi yang dipakai untuk premium C2C: jumlah unit mata uang fiat per 1 USD.
c2c.current.premium_pctnumber%Premium terhadap harga acuan.
c2c.current.threshold_usdnumberfiatUkuran order minimum yang dipakai untuk memfilter iklan P2P: setara 10.000 USD dalam mata uang lokal (terlepas dari namanya, bukan jumlah dalam USD).
c2c.current.no_thresholdboolean—True jika tidak ada iklan yang memenuhi ambang ukuran order dan harga diambil tanpa filter tersebut.
c2c.current.sourcestring—Asal nilai tersebut.
c2c.current.tsstring—String tanggal-waktu.
c2c.historyobject—Titik historis, dari yang terlama kecuali dinyatakan lain.
c2c.history.h7array—Titik mentah untuk 7 hari terakhir.
c2c.history.h7[]object—Titik mentah untuk 7 hari terakhir.
c2c.history.h7[].tstring—String tanggal-waktu.
c2c.history.h7[].vnumber—Nilai.
c2c.history.d30array—Satu titik per hari untuk 30 hari terakhir.
c2c.history.d30[]object—Satu titik per hari untuk 30 hari terakhir.
c2c.history.d30[].tstring—String tanggal-waktu.
c2c.history.d30[].vnumber—Nilai.

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

Contoh respons

/api/usdt-premium?currency=CNY · Respons nyata yang direkam 2026-11-13 04:02:47 UTC. Array dan map yang panjang dipersingkat untuk tampilan: history.h7 berisi 959 item; history.d30 berisi 31 item; c2c.history.h7 berisi 959 item; c2c.history.d30 berisi 31 item.

  • {
    • "success": true,
    • "currency": "CNY",
    • "method": "market",
    • "fx_hist": true,
    • "available": true,
    • "current": {
      • "usdt_rate": 6.66,
      • "official_fx": 6.685071,
      • "premium_pct": -0.375,
      • "ts": "2026-11-12T20:00:00.000Z"
      },
    • "history": {
      • "h7": [ … 2 ],
      • "d30": [ … 2 ]
      },
    • "c2c": {
      • "available": true,
      • "switch_date": "2026-07-20",
      • "current": { … 7 },
      • "history": { … 2 }
      }
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
2m
Mikro-cache edge
10s
Frekuensi pembaruan
setiap 10 min
Jendela
nilai saat ini, titik mentah untuk 7 hari terakhir (h7), dan satu titik per hari untuk 30 hari terakhir (d30)
Sumber data
Premium USDT terhadap kurs valas resmi, dihitung sendiri dari harga fiat USDT publik, kuotasi P2P bursa, dan kurs acuan valas publik.
Cakupan bursa
USD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, PEN, VES; COP/PEN/VES hanya memiliki data C2C; C2C RUB saat ini tidak tersedia.
Pengurutan
waktu, menaik
Satuan
percent (premium_pct); local fiat per USDT (rates)
Metode
premium_pct = (USDT price in fiat / official FX rate - 1) x 100; the market method uses aggregated fiat prices, the C2C method uses the lowest P2P buy quote above a ~10k USD order-size threshold.
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 04:02:47 UTCHTTP 20045 msSkema sesuaiTitik data terbaru berusia 8h

Ketersediaan, 30 hari terakhir

100% dari 411 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/usdt-premiumTersedia
Parameter

string · default USD — Fiat code; takes precedence over locale.

string — Locale mapped to a default fiat (e.g. zh→CNY).

URL permintaanhttps://www.coinboss.com/api/usdt-premium?currency=CNY
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.