aid: iota
url: https://raw.githubusercontent.com/api-evangelist/iota/refs/heads/main/apis.yml
name: IOTA
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Blockchain
- Distributed Ledger
- Web3
- DeFi
- Cryptocurrency
- Move
- Tangle
description: IOTA is an open-source distributed ledger technology built to bring real-world
  applications on-chain. It is the first internet-scale programmable blockchain platform
  powered by the Move programming language with horizontal scaling, feeless transactions,
  and a unique parallel transaction processing model. IOTA exposes a JSON-RPC 2.0
  API over HTTP and a GraphQL RPC for querying objects, checkpoints, transactions,
  coins, events, and on-chain state on Mainnet, Testnet, and Devnet networks. The
  platform targets trade and supply chains, decentralized finance, digital identity,
  real-world asset tokenization, and product lifecycle management.
created: '2026-06-14'
modified: '2026-06-14'
specificationVersion: '0.19'
apis:
- aid: iota:iota-coin-query-api
  name: IOTA Coin Query API
  tags:
  - Coins
  - Balances
  - Tokens
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://api.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Coin and balance-oriented JSON-RPC methods for the IOTA blockchain.
    Provides iotax_getAllBalances to retrieve total balances across all coin types
    for an address, iotax_getAllCoins to list all coin objects owned by an address,
    iotax_getBalance for the balance of a specific coin type, iotax_getCirculatingSupply
    to retrieve circulating supply summary, iotax_getCoinMetadata for token symbol,
    decimals and description, iotax_getCoins to list coins of a specific type with
    pagination, and iotax_getTotalSupply to return the total supply for a given coin
    type.
- aid: iota:iota-read-api
  name: IOTA Read API
  tags:
  - Objects
  - Checkpoints
  - Transactions
  - Events
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://api.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Core read-oriented JSON-RPC methods for the IOTA blockchain. Includes
    iota_getChainIdentifier to retrieve the genesis checkpoint digest, iota_getCheckpoint
    and iota_getCheckpoints for checkpoint data with pagination, iota_getObject and
    iota_multiGetObjects for on-chain object retrieval, iota_getTransactionBlock for
    individual transaction details, iota_multiGetTransactionBlocks for batch transaction
    lookup, iota_getEvents to query on-chain events by filter criteria, iota_getProtocolConfig
    for current protocol configuration, iota_getLatestCheckpointSequenceNumber, iota_getTotalTransactionBlocks,
    and iota_tryGetPastObject for historical object state.
- aid: iota:iota-extended-api
  name: IOTA Extended API
  tags:
  - Epochs
  - Metrics
  - Events
  - Dynamic Fields
  - Indexer
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://indexer.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Advanced indexer-exclusive JSON-RPC methods for the IOTA blockchain.
    Provides address metrics via iotax_getAllEpochAddressMetrics and iotax_getLatestAddressMetrics,
    epoch data via iotax_getCurrentEpoch and iotax_getEpochMetrics, dynamic field
    access via iotax_getDynamicFieldObject and iotax_getDynamicFields, network metrics,
    event and transaction queries with rich filtering, IOTA Names (SuiNS-compatible)
    resolution, and validator APY data. Approximately 18 methods available exclusively
    through the indexer endpoint rather than full nodes.
- aid: iota:iota-governance-read-api
  name: IOTA Governance Read API
  tags:
  - Governance
  - Validators
  - Staking
  - System State
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://api.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Governance and staking JSON-RPC methods for the IOTA blockchain. Includes
    iotax_getCommitteeInfo to retrieve committee data for specific epochs, iotax_getLatestIotaSystemState
    to return the full system state object, iotax_getReferenceGasPrice for the current
    network gas price, iotax_getStakes and iotax_getStakesByIds to query staking positions,
    iotax_getValidatorsApy for validator annual percentage yields, iotax_getCheckpointSummaryByEpoch,
    and additional epoch-scoped governance queries totaling 9 methods.
- aid: iota:iota-move-utils-api
  name: IOTA Move Utils API
  tags:
  - Move
  - Smart Contracts
  - Modules
  - Introspection
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://api.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Move language introspection JSON-RPC methods for the IOTA blockchain.
    Provides iota_getMoveFunctionArgTypes to retrieve function argument types for
    a Move function, iota_getNormalizedMoveFunction for full function structure including
    visibility and generics, iota_getNormalizedMoveModule to retrieve a normalized
    Move module, iota_getNormalizedMoveModulesByPackage to list all modules in a package,
    and iota_getNormalizedMoveStruct for detailed struct representation including
    fields and abilities. These 5 methods enable smart contract introspection and
    on-chain ABI discovery.
- aid: iota:iota-transaction-builder-api
  name: IOTA Transaction Builder API
  tags:
  - Transactions
  - Transfer
  - Staking
  - Construction
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://api.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Transaction construction JSON-RPC methods for the IOTA blockchain.
    Includes methods for building unsigned transactions such as unsafe_transferObject,
    unsafe_transferIota, unsafe_payIota, unsafe_pay, unsafe_payAllIota, unsafe_moveCall
    for Move function invocations, unsafe_requestAddStake and unsafe_requestWithdrawStake
    for staking operations, and additional batch transfer and publish methods. These
    16 unsafe transaction builder methods produce serialized unsigned transactions
    requiring subsequent signing and submission via the Write API.
- aid: iota:iota-write-api
  name: IOTA Write API
  tags:
  - Transactions
  - Execution
  - Simulation
  - Submit
  - Blockchain
  humanURL: https://docs.iota.org/iota-api-ref
  baseURL: https://api.mainnet.iota.cafe:443
  properties:
  - url: https://docs.iota.org/iota-api-ref
    type: Documentation
  - url: https://docs.iota.org/iota-api-ref
    type: APIReference
  - url: openapi/iota-jsonrpc-openapi.json
    type: OpenAPI
  description: Transaction execution and simulation JSON-RPC methods for the IOTA
    blockchain. Provides iota_executeTransactionBlock to submit a signed transaction
    to the network and return results, iota_dryRunTransactionBlock to simulate a transaction
    without broadcasting and receive full effects and events, iota_devInspectTransactionBlock
    for development inspection of transaction execution with arbitrary gas budgets,
    and iotax_estimateGasBudget for gas budget estimation. These 4 methods handle
    all state-mutating operations on the IOTA network.
- aid: iota:iota-graphql-api
  name: IOTA GraphQL API
  tags:
  - GraphQL
  - Queries
  - Objects
  - Transactions
  - Blockchain
  humanURL: https://docs.iota.org/developer/references/iota-api
  baseURL: https://graphql.mainnet.iota.cafe
  properties:
  - url: https://docs.iota.org/developer/references/iota-api
    type: Documentation
  - url: https://graphql.mainnet.iota.cafe
    type: APIReference
  - url: graphql/iota-graphql.md
    type: GraphQL
  description: GraphQL RPC interface for the IOTA blockchain, providing an alternative
    to the JSON-RPC API. Supports querying transaction blocks, objects, checkpoints,
    events, and on-chain state using GraphQL query syntax. Available on all IOTA networks
    including Mainnet at graphql.mainnet.iota.cafe, Testnet at graphql.testnet.iota.cafe,
    and Devnet at graphql.devnet.iota.cafe. Cursor-based pagination is supported for
    list operations.
- aid: iota:iota-evm-json-rpc-api
  name: IOTA EVM JSON-RPC API
  tags:
  - EVM
  - Ethereum
  - Smart Contracts
  - L2
  - Blockchain
  humanURL: https://docs.iota.org/developer/iota-evm/references/json-rpc-spec
  baseURL: https://json-rpc.evm.testnet.iotaledger.net
  properties:
  - url: https://docs.iota.org/developer/iota-evm/references/json-rpc-spec
    type: Documentation
  - url: https://docs.iota.org/developer/iota-evm/references/openapi/ethereum-json-rpc
    type: APIReference
  - url: openapi/iota-evm-wasp-openapi.yaml
    type: OpenAPI
  description: Ethereum-compatible JSON-RPC API for the IOTA EVM Layer 2. Supports
    standard Ethereum JSON-RPC methods enabling Solidity smart contract deployment
    and interaction via EVM-compatible tooling including Hardhat, Foundry, and MetaMask.
    Provides HTTP and WebSocket transports for state queries and event subscriptions.
    The IOTA EVM is a WASP-based smart contract chain with an Ethereum-compatible
    interface for cross-chain interoperability and developer migration from EVM ecosystems.
common:
- type: Website
  url: https://www.iota.org/
- type: Portal
  url: https://docs.iota.org/
- type: Documentation
  url: https://docs.iota.org/
- type: GettingStarted
  url: https://docs.iota.org/developer/getting-started
- type: APIReference
  url: https://docs.iota.org/iota-api-ref
  title: IOTA JSON-RPC API Reference
- type: Authentication
  url: https://docs.iota.org/developer/network-overview
  title: Public endpoints require no API key; load balanced and rate limited
- type: SDK
  url: https://docs.iota.org/developer/ts-sdk/
  title: IOTA TypeScript SDK
- type: SDK
  url: https://github.com/iotaledger/iota/tree/develop/crates/iota-sdk
  title: IOTA Rust SDK
- type: SDK
  url: https://docs.iota.org/developer/references/iota-api
  title: IOTA GraphQL RPC
- type: CLI
  url: https://docs.iota.org/developer/getting-started
  title: IOTA CLI
- type: GitHubOrganization
  url: https://github.com/iotaledger
- type: GitHubRepository
  url: https://github.com/iotaledger/iota
  title: IOTA Core Repository
- type: Explorer
  url: https://explorer.iota.org/
  title: IOTA Explorer (Mainnet)
- type: Faucet
  url: https://faucet.testnet.iota.cafe
  title: IOTA Testnet Faucet
- type: Blog
  url: https://blog.iota.org/
- type: NetworkOverview
  url: https://docs.iota.org/developer/network-overview
  title: IOTA Network Overview (Mainnet, Testnet, Devnet)
- type: TermsOfService
  url: https://www.iota.org/privacy-policy
- type: PrivacyPolicy
  url: https://www.iota.org/privacy-policy
- type: RateLimits
  url: rate-limits/iota-rate-limits.yml
- type: Plans
  url: plans/iota-plans.yml
- type: FinOps
  url: finops/iota-finops.yml
- type: OpenAPI
  url: openapi/iota-jsonrpc-openapi.json
  title: IOTA JSON-RPC OpenAPI 3.0 (75 methods, derived from OpenRPC)
- type: OpenAPI
  url: openapi/iota-evm-wasp-openapi.yaml
  title: IOTA EVM WASP Node REST API OpenAPI 3.0 (59 paths)
- type: OpenRPC
  url: openapi/iota-openrpc.json
  title: IOTA JSON-RPC OpenRPC Specification (source)
- type: JSONLDContext
  url: json-ld/iota-context.jsonld
  title: IOTA JSON-LD Context
- type: UseCases
  data:
  - name: DeFi Application Backend
    description: Query coin balances, object states, and submit transactions for decentralized
      finance apps on IOTA
  - name: Supply Chain Traceability
    description: Track real-world assets and product lifecycle data on the IOTA distributed
      ledger
  - name: Digital Identity
    description: Manage decentralized identifiers (DIDs) and verifiable credentials
      on-chain
  - name: Real-World Asset Tokenization
    description: Tokenize and manage traditional financial assets bridged to IOTA
      using Move smart contracts
  - name: Blockchain Analytics
    description: Query checkpoints, transaction blocks, and events for real-time analytics
      and data pipelines
  - name: Wallet Development
    description: Check coin balances, fetch transaction history, build and submit
      signed transactions
  - name: Smart Contract Development
    description: Introspect Move modules, deploy packages, and interact with on-chain
      programs via Move Utils
  - name: EVM dApp Migration
    description: Deploy existing Solidity smart contracts on IOTA EVM Layer 2 using
      standard Ethereum tooling
- type: Features
  data:
  - name: JSON-RPC 2.0 over HTTP
    description: Standard JSON-RPC 2.0 protocol over HTTP POST to IOTA full nodes
      and indexers
  - name: GraphQL RPC
    description: GraphQL interface as an alternative to JSON-RPC for flexible on-chain
      data queries
  - name: Three Network Environments
    description: Mainnet (production), Testnet (testing), and Devnet (development)
      environments with faucets
  - name: Move Smart Contracts
    description: Asset-oriented Move programming language for type-safe, resource-oriented
      smart contracts
  - name: EVM Layer 2
    description: Ethereum-compatible EVM Layer 2 chain enabling Solidity contract
      deployment and tooling reuse
  - name: No Authentication Required
    description: Public endpoints are open and require no API key for development
      and testing use
  - name: Cursor-based Pagination
    description: All list endpoints support cursor-based pagination for efficient
      data traversal
  - name: BCS Binary Encoding
    description: Binary Canonical Serialization (BCS) support alongside JSON for efficient
      data transfer
- type: GraphQL
  url: graphql/iota-graphql.md
  title: IOTA GraphQL RPC Schema and Docs
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com