Silver
- 1 richiesta al minuto
- 1,000 richieste al giorno
- Accesso commerciale autenticato
- Endpoint API di sola lettura
- Documentazione pubblica e OpenAPI
Dati Supra. Pensati per l’integrazione.
Leggi snapshot di mercato e attività on-chain tramite un contratto JSON coerente. Crea dashboard, analisi e strumenti di monitoraggio senza gestire un indexer.
Piani di accesso API
Gold
- 3 richieste al minuto
- 3,600 richieste al giorno
- Accesso commerciale autenticato
- Endpoint API di sola lettura
- Documentazione pubblica e OpenAPI
Platinum
- 5 richieste al minuto
- 5,000 richieste al giorno
- Accesso commerciale autenticato
- Endpoint API di sola lettura
- Documentazione pubblica e OpenAPI
Contatta TCP Labs per concordare accesso e condizioni commerciali. I piani differiscono per quote di richieste, non per endpoint disponibili.
Accesso commerciale, documentazione pubblica
La documentazione Supra Core e la specifica OpenAPI sono pubbliche. Il servizio API è commerciale e autenticato: ogni richiesta, anche health, richiede una chiave API valida associata a un accesso abilitato. Piani disponibili, utilizzi consentiti e condizioni commerciali sono concordati separatamente con TCP Labs.
Usa il contratto pubblico per valutare un'integrazione prima di richiedere l'accesso. Il servizio è di sola lettura: non esegue scambi, firma transazioni, gestisce wallet o custodisce asset. I bot che lo utilizzano devono limitarsi a monitoraggio, analisi e notifiche.
Endpoint di sola lettura
Tutte le route seguenti usano GET. Gli elenchi eventi FA e Legacy restano separati; gli eventi farm sono inclusi nelle risposte degli eventi di liquidità.
| Route | Utilizzo |
|---|---|
/api/v1/health | Stato del servizio, avanzamento dell'indicizzazione e aggiornamento del mercato. |
/api/v1/market/current | Elenco attuale del mercato dei token. |
/api/v1/market/pair | Una coppia token/valuta di quotazione esatta. |
/api/v1/candles | Intervalli di candele persistiti e generati dagli eventi. |
/api/v1/chart/token | Storico pronto per i grafici con punti sintetici espliciti di riporto dell'ultimo valore. |
/api/v1/fa/swaps | Eventi swap FA normalizzati. |
/api/v1/legacy/swaps | Eventi swap Legacy normalizzati. |
/api/v1/fa/liquidity-events | Eventi pool e farm FA, con filtro per token. |
/api/v1/legacy/liquidity-events | Eventi di liquidità Legacy, con filtro per token. |
/api/v1/fa/burn-events | Eventi burn FA supportati e normalizzati. |
Mantieni prezzi e importi DECIMAL come stringhe esatte. Conserva valori non disponibili e relative motivazioni; una risposta riuscita ma vuota non è un errore. Per le visualizzazioni in USD usa change_24h_usd_pct, non la variazione separata denominata nella coppia. I punti riportati nei grafici non rendono aggiornato un mercato inattivo. Consulta il contratto di ciascun endpoint per filtri, paginazione e campi probatori.
Autenticazione e prima richiesta
Invia X-API-Key oppure Authorization: Bearer. Conserva le chiavi del servizio nel tuo backend, non in un bundle pubblico del browser o in un URL. Per l'accesso autenticato tramite database, chiave, cliente e piano devono essere abilitati; vengono controllati scadenza e IP consentiti.
L'esempio legge URL base e chiave del servizio dal tuo ambiente locale. TCP Labs fornisce l'indirizzo del servizio con i dettagli di accesso. Questa pagina non contatta l'API.
curl --get "${SUPRA_CORE_API_BASE_URL}/api/v1/market/current" \
--header "X-API-Key: ${SUPRA_CORE_API_KEY}" \
--data-urlencode "network=mainnet" \
--data-urlencode "limit=20" \
--data-urlencode "offset=0"Le risposte riuscite usano ok: true con data e meta. Gli errori usano ok: false con un oggetto error contenente code e message. I parametri non validi restituiscono 400, l'autenticazione rifiutata 401, una route sconosciuta 404 e un metodo non supportato 405.
Limiti e richieste affidabili
I limiti sono assegnati al piano abilitato. Il limitatore conta le richieste in finestre fisse di un minuto e di un giorno UTC per ogni chiave API e IP client. Il superamento di una delle quote restituisce 429 con RATE_LIMITED. Il conteggio include i tentativi limitati; una nuova finestra avvia un nuovo contatore. Sono quote per finestra, non un ritardo obbligatorio tra richieste.
burst_limit è informativo nel contratto attuale: non è un limite applicato alle richieste concorrenti né un contatore burst separato. Non dedurne capacità aggiuntiva. L'header Retry-After non è garantito.
Leggi la documentazione API completa per tutti i parametri, esempi e contratti di risposta.
In caso di 429 riduci il carico e riprova più tardi con attese progressive limitate e variazioni casuali. Memorizza le letture condivise in cache e coordina i worker. Non riprovare parametri non validi o chiavi rifiutate senza correggerli. I limiti di paginazione riguardano le righe, non le quote di richieste: gli elenchi mercato ed eventi hanno pagine fino a 500 righe; le route candele e grafici hanno limiti propri documentati.