REST API endpoints supported on VeChain Mainnet and VeChain Testnet through Tatum RPC Gateway, with base URLs and an example request.
Call VeChain REST endpoints through Tatum RPC Gateway. Append the endpoint path to the network's base URL and send your API key in the x-api-key header. See Authentication.
Base URLs
| Network | Base URL |
|---|---|
| VeChain Mainnet | https://vechain-mainnet.gateway.tatum.io |
| VeChain Testnet | https://vechain-testnet.gateway.tatum.io |
Example request
curl 'https://vechain-mainnet.gateway.tatum.io/fees/priority' \
--header 'x-api-key: {YOUR_API_KEY}'Endpoints
21 endpoints. Parameters and responses are described in the VeChainThor REST API reference.
| Endpoint | Description |
|---|---|
GET /accounts/{address} | Returns the balance, energy (VTHO) and code flag of an account. |
GET /accounts/{address}/code | Returns the bytecode of a contract. |
GET /accounts/{address}/storage/{key} | Returns the value at a storage position of a contract. |
GET /blocks/{revision} | Returns a block by ID, number or label such as best or finalized. |
GET /fees/history | Returns historical base fees, gas used ratios and priority fee rewards. |
GET /fees/priority | Returns a suggested priority fee for a new transaction. |
GET /node/network/peers | Lists the peers connected to the node. |
GET /node/txpool | Lists the transactions in the transaction pool. |
GET /node/txpool/status | Returns the status of the transaction pool. |
GET /transactions/{id} | Returns a transaction by ID. |
GET /transactions/{id}/receipt | Returns the receipt of a transaction. |
POST /accounts/{address} | Deprecated. Use POST /accounts/* instead. |
POST /accounts/* | Simulates a batch of clauses to read contract state or estimate gas. |
POST /debug/storage-range | Returns a range of storage entries of a contract. |
POST /debug/tracers | Traces the execution of a transaction clause. |
POST /debug/tracers/call | Traces a simulated contract call. |
POST /events | Deprecated. Use POST /logs/event instead. |
POST /logs/event | Returns smart contract event logs that match a filter. |
POST /logs/transfer | Returns VET transfer logs that match a filter. |
POST /transactions | Submits a signed raw transaction to the network. |
POST /transfers | Deprecated. Use POST /logs/transfer instead. |
The gateway lists its supported endpoints at runtime:
Endpoint unavailable?If you need an endpoint we don't support yet, contact support.