API blockchain per le aziende: che cosa copre
Che cosa copre l'API blockchain di Chaingateway: sette chain, testnet, webhook firmati, wallet protetti da password e piani da 49 € al mese.
Verificato da Maurice Sobiera
Un’API blockchain per le aziende è un servizio web che permette a un’azienda di creare wallet, inviare e ricevere crypto e leggere i dati della chain tramite richieste HTTPS, senza gestire nodi. Chaingateway è una di queste API. Copre sette blockchain, supporta i testnet su tutte e invia webhook firmati per i depositi su sei di esse.
Questo articolo elenca che cosa copre l’API, dove sono i suoi limiti e quanto costa.
Quali blockchain supporta Chaingateway?
Chaingateway supporta Bitcoin, Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron e Solana. Tutte le chain usano la stessa autenticazione, lo stesso header X-Network e lo stesso formato di risposta. Cambiano solo i formati degli indirizzi e gli standard dei token.
| Chain | Standard dei token | Webhook |
|---|---|---|
| Bitcoin | nessuno, solo BTC nativo | sì |
| Ethereum | ERC-20, ERC-721 | sì |
| BNB Smart Chain | BEP-20, BEP-721 | sì |
| Polygon | ERC-20, ERC-721 | sì |
| Arbitrum | ERC-20, ERC-721 | sì |
| Tron | TRC-10, TRC-20, TRC-721 | sì |
| Solana | token SPL | no |
La tabella segue la definizione OpenAPI. Solana non ha webhook, quindi un’integrazione Solana deve interrogare periodicamente la rete per i trasferimenti in entrata.
Una sola API non elimina le differenze tra le chain. Commissioni, tempi di conferma e regole di finalità cambiano da chain a chain, e il codice deve gestirli comunque. Per il confronto tra due chain, vedi Solana vs Tron.
Si può testare senza fondi reali?
Sì. Si aggiunge l’header X-Network: testnet a una richiesta, e questa viene eseguita sulla rete di test della chain. Senza l’header, la richiesta va alla mainnet. Le chain corrispondono a queste reti di test:
| Chain | Testnet |
|---|---|
| Ethereum | Sepolia |
| Tron | Nile |
| BNB Smart Chain | BSC testnet |
| Bitcoin | Testnet3 |
| Polygon | Amoy |
| Arbitrum | Arbitrum Sepolia |
| Solana | Devnet |
Le monete di test non hanno valore, quindi si può eseguire un ciclo completo di deposito e pagamento senza spendere denaro. Le reti di test differiscono dalla mainnet per carico e commissioni, quindi un test riuscito sul testnet non dimostra che le impostazioni delle commissioni reggeranno sulla mainnet. La documentazione di Ethereum sulle reti spiega che cosa sono i testnet e come ottenere monete di test.
Come funzionano le notifiche di deposito?
Si crea un webhook con un URL di callback e un filtro, per esempio un indirizzo ricevente o il contratto di un token. Quando viene rilevata una transazione corrispondente, Chaingateway invia una richiesta HTTP POST al tuo URL con i dati della transazione. Questo sostituisce il polling della chain.
Due dettagli contano in produzione:
- Firma: dopo aver impostato un segreto personale nel profilo, ogni webhook porta un header
X-Signature. È un HMAC (RFC 2104) costruito a partire dall’ID della transazione e dal segreto. Verificalo prima di fidarti del payload. La guida alle firme contiene codice per Python, Java, PHP e JavaScript. - Nuovi tentativi: i webhook non vengono ripetuti automaticamente. Le notifiche fallite sono elencate sotto
/webhooks/notifications/faileddi ogni chain, e si inviano di nuovo con l’endpoint di retry.
Rendi il tuo endpoint idempotente, così che una notifica ricevuta due volte accrediti un conto una sola volta.
Come sono protette le chiavi private?
Chaingateway è non-custodial. Quando si crea un indirizzo, si può impostare una password. La chiave privata viene memorizzata cifrata con quella password, e con ogni transazione si invia la password invece della chiave. Chaingateway non memorizza le password e non può ripristinare un wallet se la password viene persa. In alternativa si può importare una chiave privata esistente e firmare le transazioni lato proprio.
I wallet protetti da password sono una comodità, non un sostituto della gestione delle chiavi. Se il backend conserva le password, chi viola il backend può spendere da quei wallet. Conserva le password in un gestore di segreti e limita il valore custodito nei wallet che il backend può sbloccare.
Quanto costa?
I piani partono da 49 € al mese, oppure da 490 € all’anno, per il piano Plus. Pro costa 99 € al mese, Premium 249 € ed Enterprise 499 €. Ogni piano inizia con una prova gratuita di 7 giorni che non richiede carta né KYC. I prezzi e i limiti attuali sono nella pagina dei prezzi.
Quali sono i limiti di ogni piano?
Ogni piano fissa limiti mensili. I valori sotto sono quelli indicati nella pagina dei prezzi al momento della stesura; controlla la pagina per i numeri attuali.
| Piano | Prezzo al mese | Transazioni al mese | Wallet | Webhook | Richieste |
|---|---|---|---|---|---|
| Plus | 49 € | 500 | 750 | 375 | 50k |
| Pro | 99 € | 2.000 | 3.000 | 1.500 | 200k |
| Premium | 249 € | 20.000 | 30.000 | 7.500 | 2M |
| Enterprise | 499 € | 100.000 | 100.000 | 25.000 | 200M |
Il supporto prioritario parte dal piano Premium, mentre con Enterprise sono inclusi un account manager dedicato e un accordo sul livello di servizio. L’oggetto quotas_left di GET /api/account mostra quanto della quota resta disponibile.
Da dove conviene iniziare?
Crea un account, copia il token dalla dashboard e chiama un endpoint di lettura su un testnet. La guida rapida illustra le prime richieste, e la pagina sulle reti supportate elenca le chain e i valori dell’header.
Come scriviamo questi articoli
Pronto a costruirlo da solo? Ottieni la tua API key — prova di 7 giorni, senza carta — oppure consulta Blockchain API per il riferimento completo degli endpoint.