Skip to main content
The IOTA JSON-RPC API provides programmatic access to the IOTA blockchain through a standard JSON-RPC 2.0 interface. The API is organized into several namespaces, each providing specific functionality.

​
API Namespaces

The JSON-RPC API is divided into the following namespaces:

​
iota Namespace

Core read and write operations:
  • Read API (iota_*) - Query transactions, objects, checkpoints, and protocol configuration
  • Write API (iota_*) - Execute transactions and call Move view functions

​
iotax Namespace

Extended functionality:
  • Coin API (iotax_*) - Query coin balances, metadata, and supply information
  • Governance API (iotax_*) - Access staking, validator, and system state data

​
Connection Information

​
Mainnet

https://api.iota.io/

​
Testnet

https://api.testnet.iota.io/

​
Local Node

http://127.0.0.1:9000/

​
Making Requests

All JSON-RPC requests follow the standard JSON-RPC 2.0 format: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "iota_getObject",
  "params": ["0x5"]
}

​
Using cURL

curl -X POST https://api.iota.io \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "iota_getChainIdentifier",
    "params": []
  }'

​
Response Format

Successful responses return a result: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {...}
}
Errors return an error object: 
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request"
  }
}

​
Rate Limits

Public nodes may enforce rate limits. For production applications, consider running your own full node.

​
API Categories

Read API

Query blockchain data including transactions, objects, and checkpoints

Write API

Execute transactions and call Move view functions

Coin API

Query coin balances, metadata, and supply information

Governance API

Access staking, validator, and governance data

​
SDK Support

For easier integration, use the official IOTA SDKs:

Build docs developers (and LLMs) love

Get started for freeTalk to us