24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/usdt-premium
GETKullanılabilir

İtibari para döviz kurlarına göre USDT OTC primi

İtibari para döviz kurlarına göre USDT OTC primi

GET/api/usdt-premium

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
currencystringİsteğe bağlıUSDUSD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, … (16)İtibari para kodu; locale parametresine göre önceliklidir. Örnek: CNY
localestringİsteğe bağlı—en, zh, zh-TW, ko, ja, es, fr, de, pt, it, ru, vi, tr, idVarsayılan bir itibari paraya eşlenen dil (ör. zh→CNY).

Örnek istek

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

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.

AlanTürBirimAçıklama
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
currencystring—Para birimi / varlık sembolü.
methodstring—Formül / yöntem notları.
fx_histboolean—Bu para birimi için günlük resmî döviz kuru geçmişi geriye dönük doldurulmuşsa true; geçmiş yalnızca canlı toplamadan birikiyorsa false.
availableboolean—Verinin mevcut olup olmadığı.
currentobject—Güncel değer.
current.usdt_ratenumberfiat per USDT1 USDT'nin `ts` anında seçilen itibari para birimi cinsinden piyasa fiyatı; herkese açık bir piyasa verisi agregatöründen alınır.
current.official_fxnumberfiat per USD`ts` anındaki resmî döviz kuru: 1 USD başına seçilen itibari para birimi miktarı (USD için 1).
current.premium_pctnumber%Referans fiyata göre prim.
current.tsstring—Tarih-saat dizesi.
historyobject—Geçmiş veri noktaları; aksi belirtilmedikçe en eskiden başlayarak.
history.h7array—Son 7 günün ham noktaları.
history.h7[]object—Son 7 günün ham noktaları.
history.h7[].tstring—Tarih-saat dizesi.
history.h7[].vnumber—Değer.
history.d30array—Son 30 gün için günde bir nokta.
history.d30[]object—Son 30 gün için günde bir nokta.
history.d30[].tstring—Tarih-saat dizesi.
history.d30[].vnumber—Değer.
c2cobject—Aynı primin eşler arası (C2C) USDT tekliflerinden ölçülen hâli; piyasa fiyatı yönteminden ayrı tutulur. Desteklenmeyen para birimlerinde null.
c2c.availableboolean—Verinin mevcut olup olmadığı.
c2c.switch_datestring—Bu para birimi için elde tutulan ilk C2C örneğinin UTC tarihi (YYYY-MM-DD); hiç örnek yoksa null.
c2c.currentobject—Güncel değer.
c2c.current.c2c_pricenumberfiat per USDT`source` alanındaki P2P platformunda, eşik emir büyüklüğünü kabul eden ilanlar arasında itibari para birimiyle 1 USDT satın almak için ilan edilen en düşük fiyat.
c2c.current.official_fxnumberfiat per USDC2C primi için kullanılan resmî döviz kuru: 1 USD başına itibari para birimi miktarı.
c2c.current.premium_pctnumber%Referans fiyata göre prim.
c2c.current.threshold_usdnumberfiatP2P ilanlarını filtrelemek için kullanılan minimum emir büyüklüğü: 10.000 USD'nin yerel para birimi karşılığı (adına rağmen USD tutarı değildir).
c2c.current.no_thresholdboolean—Hiçbir ilan emir büyüklüğü eşiğini karşılamadığında ve fiyat filtre uygulanmadan alındığında true.
c2c.current.sourcestring—Değerin nereden geldiği.
c2c.current.tsstring—Tarih-saat dizesi.
c2c.historyobject—Geçmiş veri noktaları; aksi belirtilmedikçe en eskiden başlayarak.
c2c.history.h7array—Son 7 günün ham noktaları.
c2c.history.h7[]object—Son 7 günün ham noktaları.
c2c.history.h7[].tstring—Tarih-saat dizesi.
c2c.history.h7[].vnumber—Değer.
c2c.history.d30array—Son 30 gün için günde bir nokta.
c2c.history.d30[]object—Son 30 gün için günde bir nokta.
c2c.history.d30[].tstring—Tarih-saat dizesi.
c2c.history.d30[].vnumber—Değer.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.

Örnek yanıt

/api/usdt-premium?currency=CNY · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:10 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: history.h7: 959 öğe içeriyordu; history.d30: 31 öğe içeriyordu; c2c.history.h7: 959 öğe içeriyordu; c2c.history.d30: 31 öğe içeriyordu.

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

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ığı
10 dakikada bir
Pencere
güncel değer, son 7 günün ham noktaları (h7) ve son 30 gün için günde bir nokta (d30)
Veri kaynakları
Resmî döviz kurlarına göre USDT primi; herkese açık USDT itibari para fiyatlarından, borsaların P2P kotasyonlarından ve herkese açık döviz referans kurlarından kurum içinde hesaplanır.
Borsa kapsamı
USD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, PEN, VES; COP/PEN/VES için yalnızca C2C verisi vardır; RUB C2C şu anda mevcut değil.
Sıralama
zaman, artan
Birimler
percent (premium_pct); local fiat per USDT (rates)
Yöntem
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.
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

KullanılabilirKontrol: 2026-11-13 03:58:10 UTCHTTP 20033 msŞema eşleşiyorEn yeni veri noktası 8.1h öncesine ait

Erişilebilirlik, son 30 gün

410 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ı →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu 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.
UNAUTHORIZED401`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.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika 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.
INTERNAL500Beklenmeyen 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_FAILED503Bu 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.
UNAVAILABLE501 / 503Veri 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_FAILED200Bazı 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

GET/api/usdt-premiumKullanılabilir
Parametreler

string · varsayılan USD — Fiat code; takes precedence over locale.

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

İstek URL'sihttps://www.coinboss.com/api/usdt-premium?currency=CNY
Bir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.