Ottieni la specifica API di Chaingateway

La specifica OpenAPI di Chaingateway è una descrizione leggibile da macchina dell'API REST in formato OpenAPI 3.0.3. Elenca gli endpoint per tutte e sette le chain, le forme di richiesta e risposta e l'autenticazione con Bearer token. Chaingateway è una API REST, quindi non c'è nessuna app da installare.

Che cosa contiene la specifica OpenAPI?

Descrive 202 operazioni su 164 percorsi: un endpoint per l'account, uno per i prezzi e endpoint per indirizzi, transazioni, saldi, blocchi e webhook per sette chain. Di queste operazioni, 116 sono GET, 68 POST, 12 DELETE e 6 PUT.

Chain Operazioni Standard di token Operazioni webhook
Bitcoin 21 Nessuna 8
Ethereum 31 ERC-20, ERC-721 8
BNB Smart Chain 31 BEP-20, BEP-721 8
TRON 40 TRC-10, TRC-20, TRC-721 8
Solana 15 SPL Nessuna
Polygon 31 ERC-20, ERC-721 8
Arbitrum 31 ERC-20, ERC-721 8

Il file è in YAML, circa 1 MB, con versione della specifica 2.1.0. Il server è https://app.chaingateway.io. Ogni endpoint usa l'autenticazione HTTP bearer e il token si crea sotto API tokens nella dashboard. Questi conteggi valgono al 5 novembre 2026 e cambiano quando si aggiungono endpoint.

Come genero un client dalla specifica?

Punta un generatore di codice OpenAPI al file. Il comando qui sotto crea un client TypeScript con OpenAPI Generator, e l'opzione -g sceglie il linguaggio.

npx @openapitools/openapi-generator-cli generate \
  -i https://chaingateway.io/openapi.yaml \
  -g typescript-fetch \
  -o ./chaingateway-client

Sostituisci typescript-fetch con il generatore del tuo linguaggio, per esempio python o php. Esegui una chiamata su testnet prima di fare affidamento sul codice generato. OpenAPI Generator: elenco dei generatori

Come importo la specifica in Postman o Insomnia?

Entrambi gli strumenti importano direttamente un file OpenAPI. Scegli l'opzione di importazione, poi incolla l'URL https://chaingateway.io/openapi.yaml oppure seleziona il file scaricato. Imposta l'header Authorization sul tuo Bearer token e aggiungi X-Network: testnet mentre provi.

Come chiamo l'API senza un client generato?

Invia il tuo Bearer token nell'header Authorization a https://app.chaingateway.io. Aggiungi X-Network: testnet per usare la testnet. Ometti l'header, oppure impostalo su mainnet, per la mainnet.

curl https://app.chaingateway.io/api/account \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Network: testnet"

GET /api/account è un controllo rapido per verificare che un token funzioni.

Come appaiono risposte ed errori nella specifica?

Le operazioni riuscite restituiscono HTTP 200 o 201 e gli esempi racchiudono il risultato in un involucro con i campi status, ok, message e data. Sulle 202 operazioni la specifica documenta 401 (non autenticato) 50 volte, 422 (per esempio validazione dei dati fallita o fondi insufficienti) 70 volte, 404 cinque volte e 400 una volta.

Un esempio di 401 riporta «Unauthenticated.» nel campo message. Leggi prima il codice di stato, poi il messaggio.

Esiste una versione leggibile della specifica?

Sì. Il riferimento API interattivo mostra lo stesso file, così puoi leggere gli endpoint, provare le richieste e copiare gli esempi prima di generare qualsiasi codice. Apri il riferimento API

Quali parti della specifica sono deprecate?

Le operazioni Paymaster di Tron sono ancora nel file, cinque in tutto. Paymaster è deprecato e sostituito da TronFuel, quindi non usarle nelle nuove integrazioni. Solana non ha alcun endpoint webhook.

Pronto a iniziare a sviluppare?

Ogni integrazione si basa sulla stessa API REST di Chaingateway — prova gratuita di 7 giorni, nessuna carta di credito, nessun KYC. I piani partono da 49€/mese e coprono tutte le sette chain supportate.