Verifica se il simbolo di una moneta è noto alla piattaforma
Verifica se il simbolo di una moneta è noto alla piattaforma
/api/coin-existsRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| coin | string | Facoltativo | — | — | Simbolo della moneta; se vuoto restituisce exists:false. Esempio: BTC |
Richiesta di esempio
curl -s "https://www.coinboss.com/api/coin-exists?coin=BTC"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.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| exists | boolean | — | true quando il simbolo della moneta è nell'elenco delle monete o ha almeno un record di liquidazione; false per un simbolo vuoto o sconosciuto. |
| source | string | — | Provenienza del valore. |
Generata 2026-11-11 23:01 UTC da 4 risposte reali.
Risposta di esempio
/api/coin-exists?coin=BTC · Risposta reale acquisita 2026-11-13 03:53:48 UTC.
- "success"true
- "exists"true
- "source""coins"
Campioni verificati
Oltre all'esempio qui sopra, la sonda chiama questo endpoint con i parametri seguenti e ogni volta ne verifica lo schema.
| Parametri | HTTP | Latenza | Risultato |
|---|---|---|---|
| coin=ETH | 200 | 2 ms | Superato |
| coin=SOL | 200 | 1 ms | Superato |
| coin=ARKM | 200 | 1 ms | Superato |
Verificato 2026-11-13 03:29:29 UTC
Dettagli
- Autenticazione
- Nessuna. Endpoint pubblico.
- Limite di richieste
- 1200 richieste al minuto per IP
- Cache del server
- 5m
- Micro-cache edge
- 10s
- Frequenza di aggiornamento
- elenco anagrafico delle monete aggiornato ogni 6 h (prime 2500 ogni ora); cache dell'API 300 s
- Fonti dei dati
- Verifica di esistenza sull'elenco anagrafico delle monete (elenco completo delle monete di un aggregatore di dati di mercato di terze parti) con ripiego su qualsiasi simbolo mai visto nel flusso di liquidazioni.
- Copertura degli exchange
- Circa 16.500 monete di un aggregatore di dati di mercato di terze parti più i simboli osservati nei feed di liquidazioni
- Paginazione
- nessuno
- Metodo
- exists = symbol found in coins (source="coins") else in liquidations (source="liquidations")
- Timestamp
- Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
- Formato della risposta
- json
- Stabilità
- Stabile
Stato in tempo reale
Disponibilità, ultimi 30 giorni
99.75% di 407 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 →
| Codice | HTTP | Significato | Che cosa fare |
|---|---|---|---|
| INVALID_PARAM | 400 | Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto. | Non riprovare senza modifiche; correggere la richiesta. |
| UNAUTHORIZED | 401 | L'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. |
| FORBIDDEN | 403 | La route non fa parte dell'API pubblica (interna o riservata agli account). | Non riprovare. |
| NOT_FOUND | 404 | Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste. | Non riprovare; verificare il percorso e gli identificatori nel catalogo. |
| RATE_LIMITED | 429 | Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere. | Attendere `Retry-After`, poi riprovare con backoff. |
| INTERNAL | 500 | Errore 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_FAILED | 503 | La 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. |
| UNAVAILABLE | 501 / 503 | Il 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_FAILED | 200 | Alcuni 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
/api/coin-existsDisponibilestring — Coin symbol; empty returns exists:false.
https://www.coinboss.com/api/coin-exists?coin=BTCAltro in questa categoria
- Matrice della qualità dei dati (vista del collector) /api/sd/quality
- Catalogo dell'API /api/meta/catalog
- Registro delle modifiche e politica di versionamento /api/meta/changelog
- Documentazione di un endpoint /api/meta/endpoint
- Documento OpenAPI /api/meta/openapi
- Matrice della qualità dei dati /api/meta/quality
- Stato del servizio /api/meta/status
- Verifica se il simbolo di una moneta è noto alla piattaforma /api/coin-exists
- Mappa dal simbolo della moneta al percorso dell'icona ospitata in locale /api/coin-icons
- Riepilogo aggregato della pagina moneta /api/content/coin
- Riepilogo delle sezioni dell'intero sito /api/content/summary
- Tabella dei tassi di cambio fiat /api/currency/fx
- Mappa dall'ID dell'exchange al percorso dell'icona ospitata in locale /api/exchange-icons
- Controllo di liveness /api/health
- Statistiche della pagina di ricerca /api/research/stats