JSON-RPC methods supported on Iota Mainnet, Iota Devnet and Iota Testnet through Tatum RPC Gateway, with base URLs and an example request.
Call Iota JSON-RPC methods through Tatum RPC Gateway. Send an HTTP POST request with a JSON-RPC 2.0 body to the network's base URL, with your API key in the x-api-key header. See Authentication.
Base URLs
| Network | Base URL |
|---|---|
| Iota Mainnet | https://iota-mainnet.gateway.tatum.io |
| Iota Devnet | https://iota-devnet.gateway.tatum.io |
| Iota Testnet | https://iota-testnet.gateway.tatum.io |
Example request
curl 'https://iota-mainnet.gateway.tatum.io' \
--header 'content-type: application/json' \
--header 'x-api-key: {YOUR_API_KEY}' \
--data '{"jsonrpc":"2.0","method":"iota_getLatestCheckpointSequenceNumber","params":[],"id":1}'Methods
35 methods. Parameters and responses are described in the IOTA JSON-RPC API reference; linked method names go to their page there.
| Method | Description |
|---|---|
iota_dryRunTransactionBlock | Simulates a transaction and returns its effects and gas cost without committing it. |
iota_executeTransactionBlock | Submits a signed transaction for execution and optionally waits for its effects. |
iota_getChainIdentifier | Returns the chain identifier, the first four bytes of the genesis checkpoint digest. |
iota_getCheckpoint | Returns a checkpoint by sequence number or digest. |
iota_getCheckpoints | Returns a paginated list of checkpoints. |
iota_getEvents | Returns the events emitted by a transaction. |
iota_getLatestCheckpointSequenceNumber | Returns the sequence number of the latest executed checkpoint. |
iota_getObject | Returns the data of an object by its ID. |
iota_getProtocolConfig | Returns the protocol configuration for a given version, or for the latest epoch. |
iota_getTotalTransactionBlocks | Returns the total number of transaction blocks known to the node. |
iota_getTransactionBlock | Returns a transaction by its digest. |
iota_multiGetObjects | Returns the data of multiple objects by their IDs. |
iota_multiGetTransactionBlocks | Returns an ordered list of transactions by their digests. |
iota_tryGetPastObject | Returns a past version of an object, if the node still has it. |
iota_tryMultiGetPastObjects | Returns past versions of multiple objects, if the node still has them. |
iotax_getAllBalances | Returns the total balance of every coin type owned by an address. |
iotax_getAllCoins | Returns all coin objects owned by an address. |
iotax_getBalance | Returns the total balance of one coin type owned by an address. |
iotax_getCirculatingSupply | Returns the circulating supply summary. |
iotax_getCoinMetadata | Returns the metadata of a coin type, such as symbol and decimals. |
iotax_getCoins | Returns the coin objects of a given coin type owned by an address. |
iotax_getCommitteeInfo | Returns the validator committee for a given epoch. |
iotax_getDynamicFields | Returns the dynamic fields owned by an object. |
iotax_getLatestIotaSystemState | Deprecated. Use iotax_getLatestIotaSystemStateV2 instead. |
iotax_getLatestIotaSystemStateV2 | Returns the latest IOTA system state object. |
iotax_getReferenceGasPrice | Returns the reference gas price for the network. |
iotax_getStakes | Returns all delegated stakes of an address. |
iotax_getTotalSupply | Returns the total supply of a coin type. |
iotax_iotaNamesFindAllRegistrationNFTs | Returns all IOTA Names registration NFTs owned by an address. |
iotax_iotaNamesLookup | Returns the record that an IOTA name resolves to. |
iotax_iotaNamesReverseLookup | Returns the IOTA name that an address resolves to. |
iotax_queryEvents | Returns events that match a query filter. |
iotax_queryTransactionBlocks | Returns transactions that match a query filter. |
iotax_subscribeEvent | Subscribes to events that match a filter. Requires a WebSocket connection. |
iotax_subscribeTransaction | Subscribes to transactions that match a filter. Requires a WebSocket connection. |
The gateway lists its supported methods at runtime:
Method unavailable?If you need a method we don't support yet, contact support.