Volume 24h—Open Interest—Liquidazioni 24h$1.36BLong/Short 24h—Dominanza BTC—Dominanza ETH—
App
Lingua ▾
€ EUR ▾
/api/usdt-premium
GETDisponibile

Premio OTC di USDT rispetto ai tassi di cambio fiat

Premio OTC di USDT rispetto ai tassi di cambio fiat

GET/api/usdt-premium

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
currencystringFacoltativoUSDUSD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, … (16)Codice della valuta fiat; ha la precedenza su locale. Esempio: CNY
localestringFacoltativo—en, zh, zh-TW, ko, ja, es, fr, de, pt, it, ru, vi, tr, idLingua associata a una valuta fiat predefinita (ad es. zh→CNY).

Richiesta di esempio

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

Campi della risposta

La tabella dei campi è generata da risposte reali, quindi elenca esattamente ciò che l'endpoint restituisce. I percorsi usano a[] per gli elementi di un array e {*} per gli oggetti indicizzati da un nome dinamico, come una moneta o un exchange.

CampoTipoUnitàDescrizione
successboolean—true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`.
currencystring—Simbolo della valuta / dell'asset.
methodstring—Note su formula / metodo.
fx_histboolean—True quando per questa valuta è stato caricato a posteriori lo storico giornaliero del tasso di cambio ufficiale; false quando lo storico si accumula soltanto dalla raccolta in tempo reale.
availableboolean—Indica se i dati sono disponibili.
currentobject—Valore attuale.
current.usdt_ratenumberfiat per USDTPrezzo di mercato di 1 USDT nella valuta fiat selezionata in `ts`, da un aggregatore pubblico di dati di mercato.
current.official_fxnumberfiat per USDTasso di cambio ufficiale in `ts`: unità della valuta fiat selezionata per 1 USD (1 per USD).
current.premium_pctnumber%Premio rispetto al prezzo di riferimento.
current.tsstring—Stringa di data e ora.
historyobject—Punti storici, dal meno recente, salvo diversa indicazione.
history.h7array—Punti grezzi degli ultimi 7 giorni.
history.h7[]object—Punti grezzi degli ultimi 7 giorni.
history.h7[].tstring—Stringa di data e ora.
history.h7[].vnumber—Valore.
history.d30array—Un punto al giorno per gli ultimi 30 giorni.
history.d30[]object—Un punto al giorno per gli ultimi 30 giorni.
history.d30[].tstring—Stringa di data e ora.
history.d30[].vnumber—Valore.
c2cobject—Lo stesso premio misurato sulle offerte peer-to-peer (C2C) di USDT, tenuto separato dal metodo basato sul prezzo di mercato; null per le valute non supportate.
c2c.availableboolean—Indica se i dati sono disponibili.
c2c.switch_datestring—Data UTC (YYYY-MM-DD) del primo campione C2C in archivio per questa valuta; null quando non ne esiste alcuno.
c2c.currentobject—Valore attuale.
c2c.current.c2c_pricenumberfiat per USDTPrezzo più basso tra gli annunci per acquistare 1 USDT con la valuta fiat sulla piattaforma P2P indicata in `source`, tra gli annunci che accettano la dimensione d'ordine di soglia.
c2c.current.official_fxnumberfiat per USDTasso di cambio ufficiale usato per il premio C2C: unità della valuta fiat per 1 USD.
c2c.current.premium_pctnumber%Premio rispetto al prezzo di riferimento.
c2c.current.threshold_usdnumberfiatDimensione minima dell'ordine usata per filtrare gli annunci P2P: l'equivalente in valuta locale di 10.000 USD (nonostante il nome, non è un importo in USD).
c2c.current.no_thresholdboolean—True quando nessun annuncio ha raggiunto la soglia di dimensione dell'ordine e il prezzo è stato rilevato senza il filtro.
c2c.current.sourcestring—Provenienza del valore.
c2c.current.tsstring—Stringa di data e ora.
c2c.historyobject—Punti storici, dal meno recente, salvo diversa indicazione.
c2c.history.h7array—Punti grezzi degli ultimi 7 giorni.
c2c.history.h7[]object—Punti grezzi degli ultimi 7 giorni.
c2c.history.h7[].tstring—Stringa di data e ora.
c2c.history.h7[].vnumber—Valore.
c2c.history.d30array—Un punto al giorno per gli ultimi 30 giorni.
c2c.history.d30[]object—Un punto al giorno per gli ultimi 30 giorni.
c2c.history.d30[].tstring—Stringa di data e ora.
c2c.history.d30[].vnumber—Valore.

Generata 2026-11-11 23:00 UTC da 1 risposte reali.

Risposta di esempio

/api/usdt-premium?currency=CNY · Risposta reale acquisita 2026-11-13 03:58:10 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: history.h7 conteneva 959 elementi; history.d30 conteneva 31 elementi; c2c.history.h7 conteneva 959 elementi; c2c.history.d30 conteneva 31 elementi.

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

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
2m
Micro-cache edge
10s
Frequenza di aggiornamento
ogni 10 min
Finestra
valore attuale, punti grezzi degli ultimi 7 giorni (h7) e un punto al giorno per gli ultimi 30 giorni (d30)
Fonti dei dati
Premio di USDT rispetto ai tassi di cambio ufficiali, calcolato internamente dai prezzi pubblici di USDT in valuta fiat, dalle quotazioni P2P degli exchange e dai tassi di cambio di riferimento pubblici.
Copertura degli exchange
USD, CNY, KRW, JPY, RUB, EUR, VND, TRY, IDR, ARS, MXN, BRL, CLP, COP, PEN, VES; COP/PEN/VES dispongono solo di dati C2C; il C2C in RUB al momento non è disponibile.
Ordinamento
tempo crescente
Unità
percent (premium_pct); local fiat per USDT (rates)
Metodo
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.
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:58:10 UTCHTTP 20033 msSchema conformeDato più recente risalente a 8.1h fa

Disponibilità, ultimi 30 giorni

100% di 410 verifiche superate

Errori

Le chiamate non riuscite hanno la stessa struttura su tutti gli endpoint. L'elenco completo è nella pagina degli errori. Errori e limiti di richieste →

CodiceHTTPSignificatoChe cosa fare
INVALID_PARAM400Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto.Non riprovare senza modifiche; correggere la richiesta.
UNAUTHORIZED401L'header `CB-API-KEY` è stato inviato ma la chiave è sconosciuta o revocata. I dati pubblici non richiedono alcuna chiave: rimuovere l'header o usare una chiave valida.Non riprovare senza modifiche.
FORBIDDEN403La route non fa parte dell'API pubblica (interna o riservata agli account).Non riprovare.
NOT_FOUND404Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste.Non riprovare; verificare il percorso e gli identificatori nel catalogo.
RATE_LIMITED429Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere.Attendere `Retry-After`, poi riprovare con backoff.
INTERNAL500Errore imprevisto del server. Il messaggio è volutamente generico; citare `request_id` quando lo si segnala.Riprovare una volta dopo qualche secondo; se persiste, segnalarlo con l'ID della richiesta.
UPSTREAM_FAILED503La fonte di dati alla base di questo endpoint non ha risposto in tempo. Al suo posto non vengono restituiti numeri obsoleti o sostitutivi.Riprovare con backoff; controllare la pagina di stato.
UNAVAILABLE501 / 503Il dataset è temporaneamente non pronto (riscaldamento della cache) oppure l'endpoint non ha ancora una fonte pubblica lecita.Riprovare più tardi; il catalogo contrassegna gli endpoint non disponibili per scelta progettuale.
REQUEST_FAILED200Alcuni endpoint meno recenti rispondono HTTP 200 con `success: false`. Controllare sempre `success`, non solo lo stato HTTP.Dipende dal messaggio; trattare come una richiesta non riuscita.

Prova

GET/api/usdt-premiumDisponibile
Parametri

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

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

URL della richiestahttps://www.coinboss.com/api/usdt-premium?currency=CNY
Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.