Salta ai contenuti

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.

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.

CompitoEndpoint tipicoChain
Creare un indirizzo walletPOST /api/v2/{chain}/addressesEthereum, BSC, Polygon, Arbitrum, TRON, Solana
Creare un wallet Bitcoin e i suoi indirizziPOST /api/v2/bitcoin/walletsBitcoin
Inviare coin nativiPOST /api/v2/{chain}/transactionstutte e sette
Inviare tokenPOST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPLtutte tranne Bitcoin
Leggere saldi e blocchiGET /api/v2/{chain}/balances/{address}tutte e sette
Ricevere notifiche sui pagamentiPOST /api/v2/{chain}/webhookstutte tranne Solana
Leggere un prezzo di mercatoGET /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à.

Percorso di integrazione in quattro passaggi: creare una API key, creare un indirizzo, inviare o leggere transazioni, ricevere webhook 1. Crea una API key Dashboard, token API 2. Crea un indirizzo POST /api/v2/{chain}/addresses 3. Invia e leggi le transazioni POST e GET /api/v2/{chain}/transactions 4. Ricevi i webhook POST /api/v2/{chain}/webhooks, il tuo serverrisponde 200
L'ordine abituale di un'integrazione. I passaggi 3 e 4 possono procedere in parallelo.

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.

Terminal window
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.

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.

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.

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."] }
}

Scegli la pagina che corrisponde al lavoro che hai davanti:

Le convenzioni HTTP e dei token usate in questa documentazione sono definite da standard pubblici: