Portale sviluppatori Chaingateway
Il portale sviluppatori Chaingateway documenta un’API REST per creare indirizzi, inviare transazioni, leggere i saldi e ricevere webhook su Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum e Solana. Inizia dalla guida rapida: crei una API key, invii una richiesta e passi da mainnet a testnet con un solo header.
📝 Per iniziare
Scopri le basi di Chaingateway e come iniziare a usarla
💻 Documentazione API
Esplora la documentazione della nostra Blockchain Gateway API, semplice da usare
🔔 Webhook
Scopri come il nostro sistema Instant Payment Notification può avvisarti sugli eventi blockchain
🎓 Tutorial
Trova tutorial utili su come implementare l’API Chaingateway in casi d’uso di esempio
Cosa posso fare con l’API Chaingateway?
Sezione intitolata “Cosa posso fare con l’API Chaingateway?”Puoi gestire wallet, inviare coin nativi e token, leggere dati blockchain e iscriverti alle notifiche di pagamento tramite un’unica interfaccia REST. Il file OpenAPI elenca più di 200 operazioni. Sono raggruppate per chain e lo stesso schema si ripete sulle chain EVM.
| Compito | Endpoint tipico | Chain |
|---|---|---|
| Creare un indirizzo wallet | POST /api/v2/{chain}/addresses | Ethereum, BSC, Polygon, Arbitrum, TRON, Solana |
| Creare un wallet Bitcoin e i suoi indirizzi | POST /api/v2/bitcoin/wallets | Bitcoin |
| Inviare coin nativi | POST /api/v2/{chain}/transactions | tutte e sette |
| Inviare token | POST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPL | tutte tranne Bitcoin |
| Leggere saldi e blocchi | GET /api/v2/{chain}/balances/{address} | tutte e sette |
| Ricevere notifiche sui pagamenti | POST /api/v2/{chain}/webhooks | tutte tranne Solana |
| Leggere un prezzo di mercato | GET /api/v2/market/price/{crypto}/{fiat} | indipendente dalla chain |
Solana non ha endpoint webhook, quindi i depositi su Solana vanno rilevati leggendo saldi o transazioni. I wallet sono non custodial: scegli una password che protegge la chiave memorizzata, oppure ricevi la private key nella risposta e la conservi tu. Gestione wallet spiega entrambe le modalità.
Come invio la mia prima richiesta?
Sezione intitolata “Come invio la mia prima richiesta?”Crea una API key nella dashboard, poi inviala come Bearer token nell’header Authorization. Un nuovo account parte con una prova gratuita di 7 giorni: per iniziare non servono né carta né verifica dell’identità. La richiesta seguente legge il numero dell’ultimo blocco Ethereum.
curl --request GET \ --url https://app.chaingateway.io/api/v2/ethereum/blocks/number \ --header 'Accept: application/json' \ --header 'Authorization: Bearer YOUR_API_TOKEN'Una richiesta senza token valido restituisce HTTP 401 con il corpo {"message":"Unauthenticated."}. Per eseguire la stessa chiamata sulla rete di test, aggiungi l’header X-Network: testnet. Omettilo, oppure impostalo su mainnet, per usare la rete principale. La Guida rapida mostra la configurazione dell’account, gli header e una richiesta POST in quattro linguaggi.
Quali reti supporta l’API?
Sezione intitolata “Quali reti supporta l’API?”Sono disponibili sette blockchain, ciascuna con una mainnet e una testnet. Le testnet sono Sepolia per Ethereum, Nile per TRON, la testnet di BNB Smart Chain, Bitcoin testnet3, Amoy per Polygon, Arbitrum Sepolia e Solana devnet. Reti supportate elenca ogni rete con il valore X-Network corrispondente e spiega i due valori dell’header.
Dove trovo il riferimento completo dell’API?
Sezione intitolata “Dove trovo il riferimento completo dell’API?”Il riferimento interattivo si trova su chaingateway.io/docs. È generato dallo stesso file openapi.yaml che puoi importare in Postman, Insomnia o in un generatore di codice. Ogni operazione elenca i parametri, le regole di validazione per gli indirizzi e le risposte di esempio, inclusi i corpi di errore.
Le risposte condividono un’unica struttura JSON con i campi status, ok e message. Le chiamate riuscite aggiungono data, mentre una validazione fallita aggiunge un oggetto errors. Le FAQ mostrano esempi di entrambi i casi.
Come appare una risposta?
Sezione intitolata “Come appare una risposta?”Ogni endpoint risponde con JSON. Una chiamata riuscita restituisce ok: true insieme allo stato HTTP e a un campo data. L’esempio seguente è la risposta di GET /api/v2/ethereum/gasprice.
{ "ok": true, "status": 200, "message": "Successfully parsed", "data": { "gasPrice": "12.28" }}Una validazione fallita restituisce lo stato 422 e indica ogni campo rifiutato. La stessa struttura trasporta gli errori della blockchain, ad esempio fondi insufficienti per il gas. Una password del wallet errata restituisce 401 con il messaggio Wrong password provided. Scrivi il tuo client in modo che controlli prima ok e registri message ed errors quando il valore è false.
{ "status": 422, "ok": false, "message": "Data validation failed", "errors": { "password": ["The password field is required."] }}Quale guida devo leggere dopo?
Sezione intitolata “Quale guida devo leggere dopo?”Scegli la pagina che corrisponde al lavoro che hai davanti:
- Per conservare le chiavi in modo sicuro, leggi Gestione wallet.
- Per rilevare i pagamenti in entrata, leggi Webhook, poi Sicurezza dei webhook.
- Per inviare coin, segui Creare transazioni e Creare transazioni di token.
- Per pagare le commissioni TRON senza possedere TRX, leggi Sponsorizzare le commissioni TRC20.
Le convenzioni HTTP e dei token usate in questa documentazione sono definite da standard pubblici:
- RFC 9110, HTTP Semantics per metodi, codici di stato e header.
- RFC 6750, Bearer Token Usage per l’header
Authorization: Bearer. - RFC 8259, The JSON Data Interchange Format per i corpi di richiesta e risposta.
- La documentazione per sviluppatori di Ethereum e la documentazione per sviluppatori di TRON per le chain dietro gli endpoint.