24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/usdt-premium
GETVerfügbar

USDT-OTC-Prämie gegenüber Fiat-Wechselkursen

USDT-OTC-Prämie gegenüber Fiat-Wechselkursen

GET/api/usdt-premium

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
currencystringOptionalUSDUSD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, … (16)Fiat-Code; hat Vorrang vor locale. Beispiel: CNY
localestringOptional—en, zh, zh-TW, ko, ja, es, fr, de, pt, it, ru, vi, tr, idLocale, das einer Standard-Fiatwährung zugeordnet wird (z. B. zh→CNY).

Beispielanfrage

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

Antwortfelder

Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.

FeldTypEinheitBeschreibung
successboolean—true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
currencystring—Währungs- / Asset-Symbol.
methodstring—Hinweise zu Formel / Methode.
fx_histboolean—True, wenn für diese Währung die tägliche Historie des offiziellen Wechselkurses nachgeladen wurde; false, wenn sich die Historie nur aus der Live-Erhebung aufbaut.
availableboolean—Gibt an, ob Daten verfügbar sind.
currentobject—Aktueller Wert.
current.usdt_ratenumberfiat per USDTMarktpreis von 1 USDT in der gewählten Fiatwährung zum Zeitpunkt `ts`, von einem öffentlichen Marktdatenaggregator.
current.official_fxnumberfiat per USDOffizieller Wechselkurs zum Zeitpunkt `ts`: Einheiten der gewählten Fiatwährung je 1 USD (1 für USD).
current.premium_pctnumber%Prämie gegenüber dem Referenzpreis.
current.tsstring—Datums- und Zeitangabe als Zeichenkette.
historyobject—Historische Datenpunkte, älteste zuerst, sofern nicht anders angegeben.
history.h7array—Rohdatenpunkte der letzten 7 Tage.
history.h7[]object—Rohdatenpunkte der letzten 7 Tage.
history.h7[].tstring—Datums- und Zeitangabe als Zeichenkette.
history.h7[].vnumber—Wert.
history.d30array—Ein Punkt pro Tag für die letzten 30 Tage.
history.d30[]object—Ein Punkt pro Tag für die letzten 30 Tage.
history.d30[].tstring—Datums- und Zeitangabe als Zeichenkette.
history.d30[].vnumber—Wert.
c2cobject—Dieselbe Prämie, gemessen an Peer-to-Peer-Angeboten (C2C) für USDT, getrennt von der Marktpreismethode geführt; null bei nicht unterstützten Währungen.
c2c.availableboolean—Gibt an, ob Daten verfügbar sind.
c2c.switch_datestring—UTC-Datum (YYYY-MM-DD) der ersten für diese Währung vorgehaltenen C2C-Stichprobe; null, wenn es keine gibt.
c2c.currentobject—Aktueller Wert.
c2c.current.c2c_pricenumberfiat per USDTNiedrigster inserierter Preis für den Kauf von 1 USDT mit der Fiatwährung auf dem in `source` genannten P2P-Handelsplatz, unter den Inseraten, die die Schwellen-Ordergröße akzeptieren.
c2c.current.official_fxnumberfiat per USDFür die C2C-Prämie verwendeter offizieller Wechselkurs: Einheiten der Fiatwährung je 1 USD.
c2c.current.premium_pctnumber%Prämie gegenüber dem Referenzpreis.
c2c.current.threshold_usdnumberfiatMindestordergröße zum Filtern der P2P-Inserate: der Gegenwert von 10.000 USD in Landeswährung (trotz des Namens kein USD-Betrag).
c2c.current.no_thresholdboolean—True, wenn kein Inserat die Schwelle der Ordergröße erfüllte und der Preis ohne den Filter übernommen wurde.
c2c.current.sourcestring—Herkunft des Werts.
c2c.current.tsstring—Datums- und Zeitangabe als Zeichenkette.
c2c.historyobject—Historische Datenpunkte, älteste zuerst, sofern nicht anders angegeben.
c2c.history.h7array—Rohdatenpunkte der letzten 7 Tage.
c2c.history.h7[]object—Rohdatenpunkte der letzten 7 Tage.
c2c.history.h7[].tstring—Datums- und Zeitangabe als Zeichenkette.
c2c.history.h7[].vnumber—Wert.
c2c.history.d30array—Ein Punkt pro Tag für die letzten 30 Tage.
c2c.history.d30[]object—Ein Punkt pro Tag für die letzten 30 Tage.
c2c.history.d30[].tstring—Datums- und Zeitangabe als Zeichenkette.
c2c.history.d30[].vnumber—Wert.

Erzeugt 2026-11-11 23:00 UTC aus 1 echten Antworten.

Beispielantwort

/api/usdt-premium?currency=CNY · Echte Antwort, erfasst 2026-11-13 03:58:10 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: history.h7 hatte 959 Elemente; history.d30 hatte 31 Elemente; c2c.history.h7 hatte 959 Elemente; c2c.history.d30 hatte 31 Elemente.

  • {
    • "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 }
      }
    }

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
2m
Edge-Micro-Cache
10s
Aktualisierungsintervall
alle 10 min
Zeitfenster
aktueller Wert, Rohpunkte der letzten 7 Tage (h7) und ein Punkt pro Tag für die letzten 30 Tage (d30)
Datenquellen
USDT-Prämie gegenüber offiziellen Devisenkursen, intern aus öffentlichen USDT-Fiat-Preisen, P2P-Kursen der Börsen und öffentlichen Devisen-Referenzkursen berechnet.
Börsenabdeckung
USD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, PEN, VES; für COP/PEN/VES gibt es nur C2C-Daten; RUB-C2C ist derzeit nicht verfügbar.
Sortierung
Zeit aufsteigend
Einheiten
percent (premium_pct); local fiat per USDT (rates)
Methode
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.
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:58:10 UTCHTTP 20033 msSchema stimmt übereinNeuester Datenpunkt 8.1h alt

Verfügbarkeit, letzte 30 Tage

100 % von 410 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

CodeHTTPBedeutungEmpfohlene Reaktion
INVALID_PARAM400Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED401Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel.Nicht unverändert wiederholen.
FORBIDDEN403Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).Nicht wiederholen.
NOT_FOUND404Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED429Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL500Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden.Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden.
UPSTREAM_FAILED503Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben.Mit Backoff wiederholen; die Statusseite prüfen.
UNAVAILABLE501 / 503Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle.Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind.
REQUEST_FAILED200Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status.Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln.

Ausprobieren

GET/api/usdt-premiumVerfügbar
Parameter

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

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

Anfrage-URLhttps://www.coinboss.com/api/usdt-premium?currency=CNY
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.