Get the Chaingateway
API specification
The Chaingateway OpenAPI specification is a machine-readable description of the REST API in OpenAPI 3.0.3 format. It lists the endpoints for all seven chains, their request and response shapes and the Bearer-token authentication. Chaingateway is a REST API, so there is no app to install.
What does the OpenAPI specification contain?
It describes 202 operations on 164 paths: one account endpoint, one price endpoint, and address, transaction, balance, block and webhook endpoints for seven chains. Of these, 116 operations are GET, 68 POST, 12 DELETE and 6 PUT.
| Chain | Operations | Token standards | Webhook operations |
|---|---|---|---|
| Bitcoin | 21 | None | 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 | None |
| Polygon | 31 | ERC-20, ERC-721 | 8 |
| Arbitrum | 31 | ERC-20, ERC-721 | 8 |
The file is YAML, about 1 MB, with specification version 2.1.0. The server is https://app.chaingateway.io. Every endpoint uses HTTP bearer authentication, and you create the token under API tokens in your dashboard. These counts are as of 5 November 2026 and change when endpoints are added.
How do I generate a client from the specification?
Point an OpenAPI code generator at the file. The command below creates a TypeScript client with OpenAPI Generator, and the -g option selects the language.
npx @openapitools/openapi-generator-cli generate \
-i https://chaingateway.io/openapi.yaml \
-g typescript-fetch \
-o ./chaingateway-client Replace typescript-fetch with the generator for your language, for example python or php. Run one call against testnet before you rely on the generated code. OpenAPI Generator: list of generators
How do I import the specification into Postman or Insomnia?
Both tools import an OpenAPI file directly. Choose the import option, then paste the URL https://chaingateway.io/openapi.yaml or select the downloaded file. Set the Authorization header to your Bearer token, and add X-Network: testnet while you test.
How do I call the API without a generated client?
Send your Bearer token in the Authorization header to https://app.chaingateway.io. Add X-Network: testnet to use testnet. Leave the header out, or set it to mainnet, for mainnet.
curl https://app.chaingateway.io/api/account \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Network: testnet" GET /api/account is a quick check that a token works.
How do responses and errors look in the specification?
Successful operations return HTTP 200 or 201, and the examples wrap the result in an envelope with the fields status, ok, message and data. Across the 202 operations the specification documents 401 (not authenticated) 50 times, 422 (for example data validation failed or insufficient funds) 70 times, 404 five times and 400 once.
A 401 example reads "Unauthenticated." in the message field. Read the status code first, then the message.
Is there a readable version of the specification?
Yes. The interactive API reference renders the same file, so you can read endpoints, try requests and copy examples before you generate any code. Open the API reference
Which parts of the specification are deprecated?
The Tron Paymaster operations are still in the file, five in total. Paymaster is deprecated and replaced by TronFuel, so leave them out of new integrations. Solana has no webhook endpoints at all.
Ready to build?
Every integration runs on the same Chaingateway REST API — 7-day free trial, no credit card, no KYC. Plans start at €49/month and cover all seven supported chains.