# AI.tatum.io - full content index

> Machine-readable Tatum layer for AI agents: MCP, Skills.md, workflows, and JSON APIs.

Snapshot: 2026-06-04T07:42:00.276Z
Entry manifest: https://ai.tatum.io/.well-known/tatum-agent.json

This file inlines every top-level page on the site, in navigation order, followed by every capability and workflow detail. Each section is bounded by a horizontal rule (`---`) and starts with an `<h1>` containing the page title.

If you only want the curated index without the bodies, use https://ai.tatum.io/llms.txt.

## Machine-readable endpoints

- /.well-known/tatum-agent.json (manifest) - Agent manifest (start here)
- /api/workflows (json) - Workflows
- /api/capabilities (json) - Capabilities (+ linked workflows)
- /api/mcp-tools (json) - MCP tools
- /api/chains (json) - Chain endpoints (flat, one row per interface)
- /api/blockchain-registry (json) - Blockchain registry (nested tree)
- /api/openapi-index (json) - OpenAPI index
- /llms.txt (text) - LLM-friendly URL index (llmstxt.org convention)
- /llms-full.txt (text) - Every page concatenated as one Markdown document


---

# AI.tatum.io

> The machine-readable Tatum layer for AI agents: Blockchain MCP, Skills.md code generation, task workflows, and JSON APIs for on-chain data and RPC access.

- canonical: <https://ai.tatum.io>
- html: <https://ai.tatum.io>

## What this is

Structured documentation for AI agents using Tatum. Workflows are task guides. Capabilities map product areas to tools and APIs. MCP and Skills.md are how you run calls and generate code.

## Routing

- User goal: /api/workflows and /workflows/{slug}.md
- Product areas: /api/capabilities
- Runtime: MCP at /mcp
- Codegen: Skills.md at /integration-skill
- Manifest: /.well-known/tatum-agent.json

## Counts

- Chains: 68
- Networks: 140
- MCP tools: 13
- OpenAPI operations: 126
- Snapshot at: 2026-06-04T07:42:00.276Z

## Pages

**Workflows** - Task guides - <https://ai.tatum.io/workflows>

**MCP** - Blockchain MCP - <https://ai.tatum.io/mcp>

**Skills.md** - Integration skill - <https://ai.tatum.io/integration-skill>

**Capabilities** - Product areas - <https://ai.tatum.io/workflows#capabilities>

**Docs** - API reference - <https://docs.tatum.io>

**Blockchain registry** - Chains and networks - <https://ai.tatum.io/blockchains>

## Capabilities

- RPC Gateway - <https://ai.tatum.io/capabilities/rpc-gateway>
- Wallet Portfolio - <https://ai.tatum.io/capabilities/wallet-portfolio>
- Notifications - <https://ai.tatum.io/capabilities/notifications>
- NFT Ownership - <https://ai.tatum.io/capabilities/nft-ownership>
- Exchange Rates - <https://ai.tatum.io/capabilities/exchange-rates>
- Transaction Monitoring - <https://ai.tatum.io/capabilities/transaction-monitoring>

## Workflows

- Wallet Portfolio Assistant - <https://ai.tatum.io/workflows/wallet-portfolio-assistant>
- Incoming Payment Monitor - <https://ai.tatum.io/workflows/incoming-payment-monitor>
- NFT Ownership Checker - <https://ai.tatum.io/workflows/nft-ownership-checker>
- RPC Diagnostic Agent - <https://ai.tatum.io/workflows/rpc-diagnostic-agent>

## JSON endpoints

- `/.well-known/tatum-agent.json` - <https://ai.tatum.io/.well-known/tatum-agent.json>
- `/api/workflows` - <https://ai.tatum.io/api/workflows>
- `/api/capabilities` - <https://ai.tatum.io/api/capabilities>
- `/api/mcp-tools` - <https://ai.tatum.io/api/mcp-tools>
- `/api/chains` - <https://ai.tatum.io/api/chains>
- `/api/blockchain-registry` - <https://ai.tatum.io/api/blockchain-registry>
- `/api/openapi-index` - <https://ai.tatum.io/api/openapi-index>
- `/llms.txt` - <https://ai.tatum.io/llms.txt>
- `/llms-full.txt` - <https://ai.tatum.io/llms-full.txt>


---

# Blockchain MCP

> Connect Cursor, Claude, or any MCP client to Tatum. Query blockchain data and call JSON-RPC across supported networks — install and configure in one command.

- canonical: <https://ai.tatum.io/mcp>
- html: <https://ai.tatum.io/mcp>

## Install

```bash
npm install -g @tatumio/blockchain-mcp
```

## Configure your MCP client

Add to `.cursor/mcp.json`, `.claude/mcp.json`, or your runtime's equivalent:

```json
{
  "mcpServers": {
    "tatumio": {
      "command": "npx",
      "args": [
        "@tatumio/blockchain-mcp"
      ],
      "env": {
        "TATUM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

## Available tools (13)

### Blockchain Data

| tool | description |
| --- | --- |
| get_metadata | Fetch NFT/multitoken metadata by address and IDs |
| get_wallet_balance_by_time | Get wallet balance at specific time |
| get_wallet_portfolio | Get comprehensive wallet portfolio |
| get_owners | Get owners of NFT/token |
| check_owner | Check if address owns specific token |
| get_transaction_history | Get transaction history for address |
| get_block_by_time | Get block information by timestamp |
| get_tokens | Get tokens for specific wallet |
| check_malicous_address | Check if address is malicious |
| get_exchange_rate | Get real-time exchange rates |

### RPC Gateway

| tool | description |
| --- | --- |
| gateway_get_supported_chains | Get all supported blockchain networks |
| gateway_get_supported_methods | Get supported RPC methods for chain |
| gateway_execute_rpc | Execute RPC calls on any supported chain |

## References

- <https://github.com/tatumio/blockchain-mcp>
- <https://www.npmjs.com/package/@tatumio/blockchain-mcp>
- <https://ai.tatum.io/api/mcp-tools>


---

# Skills.md

> Generate Tatum integration code directly in your repo. The Skills.md skill detects your stack, adds routes and services, and wires up your API key for you.

- canonical: <https://ai.tatum.io/integration-skill>
- html: <https://ai.tatum.io/integration-skill>

## Install

```bash
npx skills add https://github.com/tatumio/tatum-integration-skill --skill tatum
```

## Example prompts

- /tatum add balance checking for Ethereum
- /tatum add a webhook for Bitcoin transactions
- /tatum add NFT balance checking
- /tatum add 30 day daily chart for ETH/USD

## What it does

- Framework auto-detection
- Service & route code generation
- Automatic dependency installation
- .env configuration with Tatum API key
- V4 endpoints (latest, non-deprecated)
- MCP-assisted parameter & response validation

## Supported stacks

- JavaScript / TypeScript: Express, NestJS, Fastify, Koa
- Python: FastAPI, Django, Flask
- Java: Spring Boot, Quarkus, Micronaut
- PHP: Laravel, Symfony, Slim
- Go: Gin, Echo, Chi
- Ruby: Rails, Sinatra

- <https://github.com/tatumio/tatum-integration-skill>


---

# Blockchain Registry

> 68 chains and 140 networks from the Tatum registry, with chain IDs, native tokens, RPC endpoints, and gateway metadata for every supported network.

- canonical: <https://ai.tatum.io/blockchains>
- html: <https://ai.tatum.io/blockchains>

## Counts

- Chains: 68
- Networks: 140
- Endpoints (chain x network x interface): 194
- Source: <https://blockchains.tatum.io/blockchains2.json>
- Snapshot: 2026-06-04T07:42:00.276Z

## Three views, one source

- Flat lookup: `/api/chains` - one row per chain x network x interface - <https://ai.tatum.io/api/chains>
- Nested tree: `/api/blockchain-registry` - chains contain networks contain interfaces - <https://ai.tatum.io/api/blockchain-registry>
- Upstream snapshot: <https://blockchains.tatum.io/blockchains2.json>

## Endpoints

| Chain | Network | Interface | Protocol | URL |
| --- | --- | --- | --- | --- |
| Abstract | Mainnet | JSON-RPC | json-rpc | <https://abstract-mainnet.gateway.tatum.io> |
| Abstract | Testnet (testnet) | JSON-RPC | json-rpc | <https://abstract-testnet.gateway.tatum.io> |
| Algorand | Mainnet | Algod REST API | rest | <https://algorand-mainnet-algod.gateway.tatum.io> |
| Algorand | Mainnet | Indexer REST API | rest | <https://algorand-mainnet-indexer.gateway.tatum.io> |
| Algorand | Testnet (testnet) | Algod REST API | rest | <https://algorand-testnet-algod.gateway.tatum.io> |
| Algorand | Testnet (testnet) | Indexer REST API | rest | <https://algorand-testnet-indexer.gateway.tatum.io> |
| Arbitrum Nova | Mainnet | JSON-RPC | json-rpc | <https://arbitrum-nova-mainnet.gateway.tatum.io> |
| Arbitrum One | Mainnet | JSON-RPC | json-rpc | <https://arbitrum-one-mainnet.gateway.tatum.io> |
| Arbitrum One | Sepolia (testnet) | JSON-RPC | json-rpc | <https://arbitrum-one-sepolia.gateway.tatum.io> |
| Aurora | Mainnet | JSON-RPC | json-rpc | <https://aurora-mainnet.gateway.tatum.io> |
| Aurora | Testnet (testnet) | JSON-RPC | json-rpc | <https://aurora-testnet.gateway.tatum.io> |
| Avalanche | Mainnet | JSON-RPC (C-Chain) | json-rpc | <https://avalanche-mainnet.gateway.tatum.io> |
| Avalanche | Mainnet | JSON-RPC (P-Chain) | json-rpc | <https://avalanche-mainnet.gateway.tatum.io/ext/bc/P> |
| Avalanche | Mainnet | JSON-RPC (X-Chain) | json-rpc | <https://avalanche-mainnet.gateway.tatum.io/ext/bc/X> |
| Avalanche | Testnet (testnet) | JSON-RPC (C-Chain) | json-rpc | <https://avalanche-testnet.gateway.tatum.io> |
| Avalanche | Testnet (testnet) | JSON-RPC (P-Chain) | json-rpc | <https://avalanche-testnet.gateway.tatum.io/ext/bc/P> |
| Avalanche | Testnet (testnet) | JSON-RPC (X-Chain) | json-rpc | <https://avalanche-testnet.gateway.tatum.io/ext/bc/X> |
| Base | Mainnet | JSON-RPC | json-rpc | <https://base-mainnet.gateway.tatum.io> |
| Base | Sepolia (testnet) | JSON-RPC | json-rpc | <https://base-sepolia.gateway.tatum.io> |
| Berachain | Mainnet | JSON-RPC | json-rpc | <https://berachain-mainnet.gateway.tatum.io> |
| Berachain | Bepolia (testnet) | JSON-RPC | json-rpc | <https://berachain-bepolia.gateway.tatum.io> |
| Binance Smart Chain | Mainnet | JSON-RPC | json-rpc | <https://bsc-mainnet.gateway.tatum.io> |
| Binance Smart Chain | Testnet (testnet) | JSON-RPC | json-rpc | <https://bsc-testnet.gateway.tatum.io> |
| Bitcoin | Mainnet | JSON-RPC | json-rpc | <https://bitcoin-mainnet.gateway.tatum.io> |
| Bitcoin | Mainnet | REST API | rest | <https://bitcoin-mainnet.gateway.tatum.io/rest> |
| Bitcoin | Mainnet | Electrs JSON-RPC | json-rpc | <https://bitcoin-mainnet-electrs.gateway.tatum.io> |
| Bitcoin | Testnet (testnet) | JSON-RPC | json-rpc | <https://bitcoin-testnet.gateway.tatum.io> |
| Bitcoin | Testnet (testnet) | REST API | rest | <https://bitcoin-testnet.gateway.tatum.io/rest> |
| Bitcoin | Testnet4 (testnet) | JSON-RPC | json-rpc | <https://bitcoin-testnet4.gateway.tatum.io> |
| Bitcoin | Testnet4 (testnet) | REST API | rest | <https://bitcoin-testnet4.gateway.tatum.io/rest> |
| Bitcoin | Signet (testnet) | JSON-RPC | json-rpc | <https://bitcoin-signet.gateway.tatum.io> |
| Bitcoin Cash | Mainnet | JSON-RPC | json-rpc | <https://bitcoin-cash-mainnet.gateway.tatum.io> |
| Bitcoin Cash | Mainnet | REST API | rest | <https://bitcoin-cash-mainnet.gateway.tatum.io/rest> |
| Bitcoin Cash | Mainnet | ROSTRUM JSON-RPC | json-rpc | <https://bitcoin-cash-mainnet-rostrum.gateway.tatum.io> |
| Bitcoin Cash | Testnet (testnet) | JSON-RPC | json-rpc | <https://bitcoin-cash-testnet.gateway.tatum.io> |
| Bitcoin Cash | Testnet (testnet) | REST API | rest | <https://bitcoin-cash-testnet.gateway.tatum.io/rest> |
| Bitcoin Cash | Testnet (testnet) | Rostrum JSON-RPC | json-rpc | <https://bitcoin-cash-testnet-rostrum.gateway.tatum.io> |
| Cardano | Mainnet | Rosetta API | rest | <https://cardano-mainnet.gateway.tatum.io> |
| Cardano | Preprod (testnet) | Rosetta API | rest | <https://cardano-preprod.gateway.tatum.io> |
| Casper | Mainnet | JSON-RPC | json-rpc | <https://casper-mainnet.gateway.tatum.io> |
| Celo | Mainnet | JSON-RPC | json-rpc | <https://celo-mainnet.gateway.tatum.io> |
| Celo | Sepolia (testnet) | JSON-RPC | json-rpc | <https://celo-sepolia.gateway.tatum.io> |
| Chiliz | Mainnet | JSON-RPC | json-rpc | <https://chiliz-mainnet.gateway.tatum.io> |
| Chiliz | Testnet (testnet) | JSON-RPC | json-rpc | <https://chiliz-testnet.gateway.tatum.io> |
| Cosmos | Mainnet | Rosetta API | rest | <https://cosmos-mainnet.gateway.tatum.io> |
| Cosmos | Mainnet | gRPC over https | rest | <https://cosmos-mainnet.gateway.tatum.io/cosmos> |
| Cosmos | Mainnet | gRPC | gRPC | <https://cosmos-mainnet-grpc.gateway.tatum.io> |
| Cosmos | Mainnet | Tendermint JSON-RPC | json-rpc | <https://cosmos-mainnet.gateway.tatum.io/tendermint> |
| Cosmos | Mainnet | Tendermint REST API | rest | <https://cosmos-mainnet.gateway.tatum.io/tendermint> |
| Cosmos | Testnet (testnet) | gRPC over https | rest | <https://cosmos-testnet.gateway.tatum.io/cosmos> |
| Cosmos | Testnet (testnet) | gRPC | gRPC | <https://cosmos-testnet-grpc.gateway.tatum.io> |
| Cosmos | Testnet (testnet) | Tendermint JSON-RPC | json-rpc | <https://cosmos-testnet.gateway.tatum.io/tendermint> |
| Cosmos | Testnet (testnet) | Tendermint REST API | rest | <https://cosmos-testnet.gateway.tatum.io/tendermint> |
| Cronos | Mainnet | JSON-RPC | json-rpc | <https://cronos-mainnet.gateway.tatum.io> |
| Cronos | Testnet (testnet) | JSON-RPC | json-rpc | <https://cronos-testnet.gateway.tatum.io> |
| Dogecoin | Mainnet | JSON-RPC | json-rpc | <https://dogecoin-mainnet.gateway.tatum.io> |
| Dogecoin | Mainnet | REST API | rest | <https://dogecoin-mainnet.gateway.tatum.io/rest> |
| Dogecoin | Testnet (testnet) | JSON-RPC | json-rpc | <https://dogecoin-testnet.gateway.tatum.io> |
| Dogecoin | Testnet (testnet) | REST API | rest | <https://dogecoin-testnet.gateway.tatum.io/rest> |
| EOS | Mainnet | REST API | rest | <https://eos-mainnet.gateway.tatum.io> |
| EOS | Jungle (testnet) | REST API | rest | <https://eos-jungle.gateway.tatum.io> |
| Ethereum | Mainnet | JSON-RPC | json-rpc | <https://ethereum-mainnet.gateway.tatum.io> |
| Ethereum | Mainnet | Beacon API | rest | <https://ethereum-mainnet.gateway.tatum.io/eth/v1> |
| Ethereum | Sepolia (testnet) | JSON-RPC | json-rpc | <https://ethereum-sepolia.gateway.tatum.io> |
| Ethereum | Sepolia (testnet) | Beacon API | rest | <https://ethereum-sepolia.gateway.tatum.io/eth/v1> |
| Ethereum | Hoodi (testnet) | JSON-RPC | json-rpc | <https://ethereum-hoodi.gateway.tatum.io> |
| Ethereum | Hoodi (testnet) | Beacon API | rest | <https://ethereum-hoodi.gateway.tatum.io/eth/v1> |
| Ethereum Classic | Mainnet | JSON-RPC | json-rpc | <https://ethereum-classic-mainnet.gateway.tatum.io> |
| Ethereum Classic | Testnet (testnet) | JSON-RPC | json-rpc | <https://ethereum-classic-testnet.gateway.tatum.io> |
| Fantom | Mainnet | JSON-RPC | json-rpc | <https://fantom-mainnet.gateway.tatum.io> |
| Fantom | Testnet (testnet) | JSON-RPC | json-rpc | <https://fantom-testnet.gateway.tatum.io> |
| Flare | Mainnet | JSON-RPC | json-rpc | <https://flare-mainnet.gateway.tatum.io> |
| Flare | Coston (testnet) | JSON-RPC | json-rpc | <https://flare-coston.gateway.tatum.io> |
| Flare | Coston2 (testnet) | JSON-RPC | json-rpc | <https://flare-coston2.gateway.tatum.io> |
| Flare | Songbird (testnet) | JSON-RPC | json-rpc | <https://flare-songbird.gateway.tatum.io> |
| Gnosis | Mainnet | JSON-RPC | json-rpc | <https://gnosis-mainnet.gateway.tatum.io> |
| Gnosis | Testnet (testnet) | JSON-RPC | json-rpc | <https://gnosis-testnet.gateway.tatum.io> |
| HAQQ | Mainnet | JSON-RPC | json-rpc | <https://haqq-mainnet.gateway.tatum.io> |
| HAQQ | Testnet (testnet) | JSON-RPC | json-rpc | <https://haqq-testnet.gateway.tatum.io> |
| Harmony | Mainnet S0 | JSON-RPC | json-rpc | <https://harmony-mainnet-s0.gateway.tatum.io> |
| Harmony | Testnet S0 (testnet) | JSON-RPC | json-rpc | <https://harmony-testnet-s0.gateway.tatum.io> |
| Harmony | Devnet S0 (testnet) | JSON-RPC | json-rpc | <https://harmony-devnet-s0.gateway.tatum.io> |
| HyperEVM | Mainnet | JSON-RPC | json-rpc | <https://hyperevm-mainnet.gateway.tatum.io> |
| HyperEVM | Testnet (testnet) | JSON-RPC | json-rpc | <https://hyperevm-testnet.gateway.tatum.io> |
| Iota | Mainnet | JSON-RPC | json-rpc | <https://iota-mainnet.gateway.tatum.io> |
| Iota | Testnet (testnet) | JSON-RPC | json-rpc | <https://iota-testnet.gateway.tatum.io> |
| Iota | Devnet (testnet) | JSON-RPC | json-rpc | <https://iota-devnet.gateway.tatum.io> |
| Kaia | Mainnet | JSON-RPC | json-rpc | <https://kaia-mainnet.gateway.tatum.io> |
| Kaia | Kairos (testnet) | JSON-RPC | json-rpc | <https://kaia-kairos.gateway.tatum.io> |
| Katana | Mainnet | JSON-RPC | json-rpc | <https://katana-mainnet.gateway.tatum.io> |
| Katana | Bokuto (testnet) | JSON-RPC | json-rpc | <https://katana-bokuto.gateway.tatum.io> |
| Kucoin | Mainnet | JSON-RPC | json-rpc | <https://kucoin-mainnet.gateway.tatum.io> |
| Kucoin | Testnet (testnet) | JSON-RPC | json-rpc | <https://kucoin-testnet.gateway.tatum.io> |
| Kusama | Mainnet | JSON-RPC | json-rpc | <https://kusama-mainnet.gateway.tatum.io> |
| Kusama | Mainnet | Substrate API | rest | <https://kusama-mainnet.gateway.tatum.io/substrateapi> |
| Kusama | Mainnet | REST API | rest | <https://kusama-mainnet.gateway.tatum.io/v1> |
| Kusama Asset Hub | Mainnet | JSON-RPC | json-rpc | <https://kusama-assethub.gateway.tatum.io> |
| Kusama Asset Hub | Mainnet | Substrate API | rest | <https://kusama-assethub.gateway.tatum.io/substrateapi> |
| Kusama Asset Hub | Mainnet | REST API | rest | <https://kusama-assethub.gateway.tatum.io/v1> |
| Lisk | Mainnet | JSON-RPC | json-rpc | <https://lisk-mainnet.gateway.tatum.io> |
| Lisk | Sepolia (testnet) | JSON-RPC | json-rpc | <https://lisk-sepolia.gateway.tatum.io> |
| Litecoin | Mainnet | JSON-RPC | json-rpc | <https://litecoin-mainnet.gateway.tatum.io> |
| Litecoin | Mainnet | REST API | rest | <https://litecoin-mainnet.gateway.tatum.io/rest> |
| Litecoin | Testnet (testnet) | JSON-RPC | json-rpc | <https://litecoin-testnet.gateway.tatum.io> |
| Litecoin | Testnet (testnet) | REST API | rest | <https://litecoin-testnet.gateway.tatum.io/rest> |
| Lumia | Mainnet | JSON-RPC | json-rpc | <https://lumia-mainnet.gateway.tatum.io> |
| Lumia | Beam (testnet) | JSON-RPC | json-rpc | <https://lumia-beam.gateway.tatum.io> |
| MANTRA Chain | Mainnet | JSON-RPC | json-rpc | <https://mantrachain-mainnet.gateway.tatum.io> |
| MANTRA Chain | Dukong with EVM (testnet) | JSON-RPC | json-rpc | <https://mantrachain-dukongevm.gateway.tatum.io> |
| MegaETH | timothy (testnet) | JSON-RPC | json-rpc | <https://megaeth-timothy.gateway.tatum.io> |
| Moca Chain | Mainnet | JSON-RPC | json-rpc | <https://mocachain-mainnet.gateway.tatum.io> |
| Moca Chain | Testnet (testnet) | JSON-RPC | json-rpc | <https://mocachain-testnet.gateway.tatum.io> |
| Monacoin | Mainnet | JSON-RPC | json-rpc | <https://monacoin-mainnet.gateway.tatum.io> |
| MONAD | Mainnet | JSON-RPC | json-rpc | <https://monad-mainnet.gateway.tatum.io> |
| MONAD | Testnet (testnet) | JSON-RPC | json-rpc | <https://monad-testnet.gateway.tatum.io> |
| Moonbeam | Mainnet | JSON-RPC | json-rpc | <https://moonbeam-mainnet.gateway.tatum.io> |
| Moonbeam | Moonriver | JSON-RPC | json-rpc | <https://moonbeam-moonriver.gateway.tatum.io> |
| Moonbeam | Moonbase Alpha (testnet) | JSON-RPC | json-rpc | <https://moonbeam-moonbase.gateway.tatum.io> |
| MultiversX | Mainnet | REST API | rest | <https://multiversx-mainnet.gateway.tatum.io> |
| MultiversX | Testnet (testnet) | REST API | rest | <https://multiversx-testnet.gateway.tatum.io> |
| MultiversX | Devnet (testnet) | REST API | rest | <https://multiversx-devnet.gateway.tatum.io> |
| NEAR | Mainnet | JSON-RPC | json-rpc | <https://near-mainnet.gateway.tatum.io> |
| NEAR | Testnet (testnet) | JSON-RPC | json-rpc | <https://near-testnet.gateway.tatum.io> |
| Oasis | Mainnet | JSON-RPC | json-rpc | <https://oasis-mainnet.gateway.tatum.io> |
| Oasis | Emerald (testnet) | JSON-RPC | json-rpc | <https://oasis-emerald.gateway.tatum.io> |
| Optimism | Mainnet | JSON-RPC | json-rpc | <https://optimism-mainnet.gateway.tatum.io> |
| Optimism | Testnet (testnet) | JSON-RPC | json-rpc | <https://optimism-testnet.gateway.tatum.io> |
| Plasma | Mainnet | JSON-RPC | json-rpc | <https://plasma-mainnet.gateway.tatum.io> |
| Plasma | Testnet (testnet) | JSON-RPC | json-rpc | <https://plasma-testnet.gateway.tatum.io> |
| Plume | Mainnet | JSON-RPC | json-rpc | <https://plume-mainnet.gateway.tatum.io> |
| Plume | Testnet (testnet) | JSON-RPC | json-rpc | <https://plume-testnet.gateway.tatum.io> |
| Polkadot | Mainnet | JSON-RPC | json-rpc | <https://polkadot-mainnet.gateway.tatum.io> |
| Polkadot | Mainnet | Substrate API | rest | <https://polkadot-mainnet.gateway.tatum.io/substrateapi> |
| Polkadot | Mainnet | REST API | rest | <https://polkadot-mainnet.gateway.tatum.io/v1> |
| Polkadot | Westend (testnet) | JSON-RPC | json-rpc | <https://polkadot-westend.gateway.tatum.io> |
| Polkadot | Westend (testnet) | REST API | rest | <https://polkadot-westend.gateway.tatum.io/v1> |
| Polkadot Asset Hub | Mainnet | JSON-RPC | json-rpc | <https://polkadot-assethub.gateway.tatum.io> |
| Polkadot Asset Hub | Mainnet | Substrate API | rest | <https://polkadot-assethub.gateway.tatum.io/substrateapi> |
| Polkadot Asset Hub | Mainnet | REST API | rest | <https://polkadot-assethub.gateway.tatum.io/v1> |
| Polygon | Mainnet | JSON-RPC | json-rpc | <https://polygon-mainnet.gateway.tatum.io> |
| Polygon | Amoy (testnet) | JSON-RPC | json-rpc | <https://polygon-amoy.gateway.tatum.io> |
| Ripple | Mainnet | REST API | rest | <https://ripple-mainnet.gateway.tatum.io> |
| Ripple | Testnet (testnet) | REST API | rest | <https://ripple-testnet.gateway.tatum.io> |
| Ronin | Mainnet | JSON-RPC | json-rpc | <https://ronin-mainnet.gateway.tatum.io> |
| Ronin | Saigon (testnet) | JSON-RPC | json-rpc | <https://ronin-saigon.gateway.tatum.io> |
| Rootstock | Mainnet | JSON-RPC | json-rpc | <https://rootstock-mainnet.gateway.tatum.io> |
| Rootstock | Testnet (testnet) | JSON-RPC | json-rpc | <https://rootstock-testnet.gateway.tatum.io> |
| Solana | Mainnet | JSON-RPC | json-rpc | <https://solana-mainnet.gateway.tatum.io> |
| Solana | Mainnet | gRPC | gRPC | <https://solana-mainnet-grpc.gateway.tatum.io> |
| Solana | Devnet (testnet) | JSON-RPC | json-rpc | <https://solana-devnet.gateway.tatum.io> |
| Sonic | Mainnet | JSON-RPC | json-rpc | <https://sonic-mainnet.gateway.tatum.io> |
| Sonic | Blaze (testnet) | JSON-RPC | json-rpc | <https://sonic-blaze.gateway.tatum.io> |
| Stellar | Mainnet | Horizon REST API | rest | <https://stellar-mainnet.gateway.tatum.io/> |
| Stellar | Mainnet | Soroban JSON-RPC | json-rpc | <https://stellar-mainnet-soroban.gateway.tatum.io/> |
| Stellar | Testnet (testnet) | Horizon REST API | rest | <https://stellar-testnet.gateway.tatum.io> |
| Stellar | Testnet (testnet) | Soroban JSON-RPC | json-rpc | <https://stellar-testnet-soroban.gateway.tatum.io/> |
| Sui | Mainnet | JSON-RPC | json-rpc | <https://sui-mainnet.gateway.tatum.io> |
| Sui | Mainnet | gRPC | gRPC | <https://sui-mainnet-grpc.gateway.tatum.io> |
| Sui | Testnet (testnet) | JSON-RPC | json-rpc | <https://sui-testnet.gateway.tatum.io> |
| Sui | Testnet (testnet) | gRPC | gRPC | <https://sui-testnet-grpc.gateway.tatum.io> |
| Sui | Devnet (testnet) | JSON-RPC | json-rpc | <https://sui-devnet.gateway.tatum.io> |
| Tezos | Mainnet | REST API | rest | <https://tezos-mainnet.gateway.tatum.io> |
| Tezos | Shadownet (testnet) | REST API | rest | <https://tezos-shadownet.gateway.tatum.io> |
| The Open Network | Mainnet | V3 - Indexer | rest | <https://ton-mainnet.gateway.tatum.io/api/v3> |
| The Open Network | Mainnet | V2 - TON HTTP API | rest | <https://ton-mainnet.gateway.tatum.io> |
| The Open Network | Testnet (testnet) | V3 - Indexer | rest | <https://ton-testnet.gateway.tatum.io/api/v3> |
| The Open Network | Testnet (testnet) | V2 - TON HTTP API | rest | <https://ton-testnet.gateway.tatum.io> |
| Tron | Mainnet | JSON-RPC | json-rpc | <https://tron-mainnet.gateway.tatum.io/jsonrpc> |
| Tron | Mainnet | HTTP API | rest | <https://tron-mainnet.gateway.tatum.io/wallet> |
| Tron | Mainnet | Solidity HTTP API | rest | <https://tron-mainnet.gateway.tatum.io/walletsolidity> |
| Tron | Shasta (testnet) | JSON-RPC | json-rpc | <https://tron-shasta.gateway.tatum.io/jsonrpc> |
| Tron | Shasta (testnet) | HTTP API | rest | <https://tron-shasta.gateway.tatum.io/wallet> |
| Tron | Shasta (testnet) | Solidity HTTP API | rest | <https://tron-shasta.gateway.tatum.io/walletsolidity> |
| Tron | Nile (testnet) | JSON-RPC | json-rpc | <https://tron-nile.gateway.tatum.io/jsonrpc> |
| Tron | Nile (testnet) | HTTP API | rest | <https://tron-nile.gateway.tatum.io/wallet> |
| Tron | Nile (testnet) | Solidity HTTP API | rest | <https://tron-nile.gateway.tatum.io/walletsolidity> |
| Unichain | Mainnet | JSON-RPC | json-rpc | <https://unichain-mainnet.gateway.tatum.io> |
| Unichain | Sepolia (testnet) | JSON-RPC | json-rpc | <https://unichain-sepolia.gateway.tatum.io> |
| VeChain | Mainnet | REST API | rest | <https://vechain-mainnet.gateway.tatum.io> |
| VeChain | Testnet (testnet) | REST API | rest | <https://vechain-testnet.gateway.tatum.io> |
| XinFin (XDC) | Mainnet | JSON-RPC | json-rpc | <https://xdc-mainnet.gateway.tatum.io> |
| XinFin (XDC) | Testnet (testnet) | JSON-RPC | json-rpc | <https://xdc-testnet.gateway.tatum.io> |
| xlayer | Mainnet | JSON-RPC | json-rpc | <https://xlayer-mainnet.gateway.tatum.io> |
| xlayer | Testnet (testnet) | JSON-RPC | json-rpc | <https://xlayer-testnet.gateway.tatum.io> |
| Zcash | Mainnet | JSON-RPC | json-rpc | <https://zcash-mainnet.gateway.tatum.io> |
| Zcash | Mainnet | REST API | rest | <https://zcash-mainnet.gateway.tatum.io/rest> |
| Zcash | Mainnet | Zebrad JSON-RPC | json-rpc | <https://zcash-mainnet-zebrad.gateway.tatum.io> |
| Zcash | Testnet (testnet) | JSON-RPC | json-rpc | <https://zcash-testnet.gateway.tatum.io> |
| Zcash | Testnet (testnet) | REST API | rest | <https://zcash-testnet.gateway.tatum.io/rest> |
| Zcash | Testnet (testnet) | Zebrad JSON-RPC | json-rpc | <https://zcash-testnet-zebrad.gateway.tatum.io> |
| Zilliqa | Mainnet | JSON-RPC | json-rpc | <https://zilliqa-mainnet.gateway.tatum.io> |
| Zilliqa | Testnet (testnet) | JSON-RPC | json-rpc | <https://zilliqa-testnet.gateway.tatum.io> |
| ZKsync | Mainnet | JSON-RPC | json-rpc | <https://zksync-mainnet.gateway.tatum.io> |
| ZKsync | Testnet (testnet) | JSON-RPC | json-rpc | <https://zksync-sepolia.gateway.tatum.io> |


---

# Open API

> 2 mirrored Tatum OpenAPI schemas with 126 operations. Fetch the JSON locally or filter the operations table by method, path, tag, or summary.

- canonical: <https://ai.tatum.io/openapi>
- html: <https://ai.tatum.io/openapi>

## Schemas

| id | title | version | openapi | paths | operations | tags | source |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `blockchain-data` | Blockchain Data | 1.2 | 3.1.0 | 106 | 107 | 15 | <https://docs.tatum.io/openapi/blockchain-data-1.json> |
| `notifications` | Blockchain Notifications | 3.7.3 | 3.1.0 | 11 | 19 | 3 | <https://docs.tatum.io/openapi/notifications-1.json> |

## Blockchain Data - operations

- Tags: Blockchains API, DeFi API, Exchange rate, Fee Estimation API, Malicious address, Marketplace, Mining API, NFT API, Prediction API, Staking, Storage API, Token API, Transactions API, Wallet API, Web3 Name Service
- Source: <https://docs.tatum.io/openapi/blockchain-data-1.json>

| method | path | operationId | tags | summary |
| --- | --- | --- | --- | --- |
| GET | `/v4/data/defi/swaps/quote` | GetV4DataDefiSwapsQuote | DeFi API | Get best swap rate |
| GET | `/v4/data/defi/swaps/quotes` | GetV4DataDefiSwapsQuotes | DeFi API | Get multi-protocol rates |
| GET | `/v4/data/collections` | GetCollectionsV4 | NFT API | Get tokens from a collection |
| GET | `/v4/data/metadata` | GetMetadataV4 | NFT API | Get token metadata |
| GET | `/v4/data/wallet/portfolio` | GetWalletPortfolioV4 | Wallet API | Get wallet portfolio |
| GET | `/v4/data/wallet/balance/time` | GetWalletBalanceByTimeV4 | Wallet API | Get balances by time of addresses |
| GET | `/v4/data/wallet/reputation` | GetWalletReputationV4 | Wallet API | Get wallet reputation |
| GET | `/v4/data/wallet/reputation/portfolio` |  | Wallet API | Get wallet reputation portfolio |
| GET | `/v4/data/wallet/reputation/tokens` | GetWalletReputationTokensV4 | Wallet API | Get wallet reputation by tokens |
| GET | `/v4/data/ns/name` | NameToAddressV4 | Web3 Name Service | Resolve address by domain |
| GET | `/v4/data/owners` | GetOwnersV4 | NFT API | Get owners of a token |
| GET | `/v4/data/owners/address` | CheckOwnerV4 | NFT API | Check owner of token |
| GET | `/v4/data/nft/balances` | GetNftBalancesV4 | NFT API | Get NFT balance of a wallet address |
| GET | `/v4/data/multitoken/balances` | GetMultiTokenBalanceV4 | NFT API | Get Multi Token balances of a wallet address |
| GET | `/v4/data/transaction/history` | GetTransactionHistoryV4 | Transactions API | Get transaction history |
| GET | `/v4/data/transactions/hash` | GetTransactionsByHashV4 | Transactions API | Get transactions by hash |
| GET | `/v4/data/defi/events` | GetDefiEventsV4 | DeFi API | Get specified events |
| GET | `/v4/data/defi/blocks` | GetDefiBlocksV4 | DeFi API | Get specified blocks |
| GET | `/v4/data/defi/blocks/latest` | GetLatestDefiBlockV4 | DeFi API | Get latest block |
| GET | `/v4/data/block/time` | GetBlockByTimeV4 | DeFi API | Get block by time |
| GET | `/v4/data/blockchains/block/current` | GetCurrentBlockBlockchainsApi | Blockchains API | Get current block height |
| GET | `/v4/data/blockchains/block` | GetBlockBlockchainsApi | Blockchains API | Get block by hash or height |
| GET | `/v4/data/blockchains/block/hash` | GetBlockHashBlockchainsApi | Blockchains API | Get block hash by block number |
| GET | `/v4/data/blockchains/utxo/info` | GetUtxoInfoBlockchainsApi | Blockchains API | Get UTXO info by tx hash and index |
| GET | `/v4/data/blockchains/mempool` | GetMempoolBlockchainsApi | Blockchains API | Get mempool transaction hashes |
| GET | `/v4/data/blockchains/transaction` | GetTransactionBlockchainsApi | Blockchains API | Get transaction by hash |
| GET | `/v4/data/blockchains/transaction/internal` | GetInternalTransactionsBlockchainsApi | Blockchains API | Get internal transactions by address |
| GET | `/v4/data/blockchains/balance` | GetBalanceBlockchainsApi | Blockchains API | Get native balance |
| GET | `/v4/data/blockchains/balance/batch` | GetBalanceBatchBlockchainsApi | Blockchains API | Get native balance (batch) |
| GET | `/v4/data/blockchains/transaction/count` | GetTransactionCountBlockchainsApi | Blockchains API | Get outgoing transaction count |
| GET | `/v4/data/blockchains/transaction/history/utxos` | GetTransactionHistoryUtxosBlockchainsApi | Blockchains API | Get transaction history (UTXO) |
| POST | `/v4/data/blockchains/transaction/history/utxos/batch` | GetTransactionHistoryUtxosBatchBlockchainsApi | Blockchains API | Get transaction history (UTXO) batch |
| GET | `/v4/data/tokens` | GetTokensV4 | Token API | Get information about collection or token |
| GET | `/v4/data/tokens/trending` | GetTrendingTokensV4 | Token API | Get trending tokens |
| GET | `/v4/data/tokens/newest` | GetNewestTokensV4 | Token API | Get newest tokens |
| GET | `/v4/data/tokens/popular` | GetPopularTokensV4 | Token API | Get popular tokens |
| GET | `/v4/data/tokens/popular/history` | GetPopularTokensHistoryV4 | Token API | Get popular tokens history |
| GET | `/v4/data/transactions/dna` | GetTransfersDnaV4 | Token API | Get transactions DNA |
| GET | `/v4/data/rate/history` | getExchangeRateHistoryBySymbol | Token API | Get Exchange Rate History by Symbol |
| GET | `/v4/data/utxos` | GetUtxosByAddressV4 | Wallet API | Get unspent UTXOs for an address |
| POST | `/v4/data/utxos/batch` | GetUtxosByAddressBatchV4 | Wallet API | Get unspent UTXOs for a batch of addresses |
| GET | `/v3/security/address/{address}` | CheckMalicousAddress | Malicious address | Check malicous address |
| GET | `/v4/data/rate/symbol` | getExchangeRateBySymbol | Exchange rate | Get Exchange Rate by Symbol |
| POST | `/v4/data/rate/symbol/batch` | getExchangeRatesBySymbol | Exchange rate | Get Exchange Rate by Symbol - Batch |
| GET | `/v4/data/rate/symbol/OHLCV` | getSymbolOHLCV | Exchange rate | Get OHLCV by Symbol |
| GET | `/v4/data/rate/symbol/OHLCV/batch` | getSymbolOHLCVBatch | Exchange rate | Get OHLCV by Symbol - Batch |
| GET | `/v4/data/rate/price-change` | getPriceChange | Exchange rate | Get Price Change by Symbol |
| POST | `/v4/data/rate/price-change/batch` | getPriceChangeBatch | Exchange rate | Get Price Change by Symbol - Batch |
| GET | `/v4/data/rate/contract` | getExchangeRateByContractAddress | Exchange rate | Get Exchange Rate by Contract |
| POST | `/v4/data/rate/contract/batch` | getExchangeRatesByContractAddress | Exchange rate | Get Exchange Rate by Contract - Batch |
| GET | `/v4/data/staking/native/current-assets` | GetCurrentStakedAssetsV4 | Staking | Get current staked assets |
| GET | `/v4/data/staking/native/current-assets-by-validator` | GetCurrentStakedAssetsByValidatorV4 | Staking | Get current staked assets by validator |
| GET | `/v4/data/staking/native/rewards` | GetStakedAccountRewardsV4 | Staking | Get staked account rewards |
| POST | `/v4/data/staking/native/rewards/batch` | GetStakedAccountRewardsBatchV4 | Staking | Get staked account rewards - Batch |
| GET | `/v4/data/staking/native/transactions` | GetStakingTransactionsV4 | Staking | Get staking transactions |
| GET | `/v4/data/staking/native/pools` | GetStakingPoolsV4 | Staking | Get staking pools |
| GET | `/v4/data/staking/liquid/current-assets` | GetLiquidStakingCurrentAssetsV4 | Staking | Get liquid staking current assets |
| GET | `/v4/data/staking/liquid/pools` | GetLiquidStakingPoolsV4 | Staking | Get liquid staking pools |
| GET | `/v4/data/mining/rewards` | GetMiningRewardsV4 | Mining API | Get mining rewards |
| GET | `/v4/data/mining/totalRewards` | GetTotalMiningRewardsV4 | Mining API | Get total mining rewards |
| POST | `/v4/blockchainOperations/gas` | estimateGas | Fee Estimation API | Estimate gas for a transfer |
| GET | `/v3/blockchain/fee/{chain}` | getBlockchainFee | Fee Estimation API | Get recommended base fee for a chain |
| POST | `/v3/blockchain/estimate` | EstimateFeeBlockchain | Fee Estimation API | Estimate gas for a transaction |
| POST | `/v3/ethereum/gas/batch` | EthEstimateGasBatch | Fee Estimation API | Estimate the fee for multiple Ethereum transactions |
| POST | `/v3/xdc/gas` | XdcEstimateGas | Fee Estimation API | Estimate the fee for a XinFin transaction |
| POST | `/v3/vet/transaction/gas` | VetEstimateGas | Fee Estimation API | Estimate the gas needed for a VeChain transaction |
| GET | `/v4/data/marketplace/cryptoslam/token/trending` | GetCryptoslamTrendingTokens | Marketplace | Get trending tokens from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/price` | GetCryptoslamTokenPrice | Marketplace | Get token prices from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/price/history` | GetCryptoslamTokenPriceHistory | Marketplace | Get token price history from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/price/exotic` | GetCryptoslamTokenPriceExotic | Marketplace | Get exotic token prices from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/price/exotic/history` | GetCryptoslamTokenPriceExoticHistory | Marketplace | Get exotic token price history from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/trades` | GetCryptoslamTokenTrades | Marketplace | Get token trades from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/transfers` | GetCryptoslamTokenTransfers | Marketplace | Get token transfers from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/transfers/dna` | GetCryptoslamTokenTransfersDna | Marketplace | Get token transfers with DNA from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/token/holder/reputation` | GetCryptoslamTokenHolderReputation | Marketplace | Get token holder reputation from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/chain/trades` | GetCryptoslamChainTrades | Marketplace | Get chain trades from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/chain/trades/dna` | GetCryptoslamChainTradesDna | Marketplace | Get chain trades DNA from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/chain/transfers` | GetCryptoslamChainTransfers | Marketplace | Get chain transfers from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/chain/transfers/dna` | GetCryptoslamChainTransfersDna | Marketplace | Get chain transfers DNA from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/wallet/trades` | GetCryptoslamWalletTrades | Marketplace | Get wallet trades from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/wallet/trades/dna` | GetCryptoslamWalletTradesDna | Marketplace | Get wallet trades DNA from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/wallet/transfers` | GetCryptoslamWalletTransfers | Marketplace | Get wallet transfers from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/wallet/transfers/dna` | GetCryptoslamWalletTransfersDna | Marketplace | Get wallet transfers DNA from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/pair/trades` | GetCryptoslamPairTrades | Marketplace | Get pair trades from Cryptoslam |
| GET | `/v4/data/marketplace/cryptoslam/pair/trades/dna` | GetCryptoslamPairTradesDna | Marketplace | Get pair trades DNA from Cryptoslam |
| POST | `/v4/data/storage/upload` | StorageUpload | Storage API | Upload a file to Walrus storage |
| GET | `/v4/data/storage/uploads` | StorageListUploads | Storage API | List Walrus storage uploads |
| GET | `/v4/data/storage/upload/{jobId}` | StorageGetUploadStatus | Storage API | Get Walrus storage upload status |
| DELETE | `/v4/data/storage/upload/{jobId}` | StorageCancelRenewal | Storage API | Cancel Walrus storage renewal |
| GET | `/v4/data/prediction/events` | GetPredictionEventsV4 | Prediction API | List prediction-market events |
| GET | `/v4/data/prediction/events/{id}` | GetPredictionEventByIdV4 | Prediction API | Get a prediction-market event by ID |
| GET | `/v4/data/prediction/markets` | GetPredictionMarketsV4 | Prediction API | List prediction markets |
| GET | `/v4/data/prediction/markets/{id}` | GetPredictionMarketByIdV4 | Prediction API | Get a prediction market by ID |
| GET | `/v4/data/prediction/markets/{id}/price` | GetPredictionMarketPriceV4 | Prediction API | Get current market price |
| GET | `/v4/data/prediction/markets/{id}/orderbook` | GetPredictionMarketOrderbookV4 | Prediction API | Get current market orderbook |
| GET | `/v4/data/prediction/markets/{id}/history` | GetPredictionMarketPriceHistoryV4 | Prediction API | Get market price history |
| GET | `/v4/data/prediction/markets/{id}/trades` | GetPredictionMarketTradesV4 | Prediction API | Get recent market trades |
| GET | `/v4/data/prediction/markets/{id}/positions` | GetPredictionMarketPositionsV4 | Prediction API | Get top holders of a market |
| GET | `/v4/data/prediction/wallets/{address}/portfolio` | GetPredictionWalletPortfolioV4 | Prediction API | Get wallet portfolio summary |
| GET | `/v4/data/prediction/wallets/{address}/positions` | GetPredictionWalletPositionsV4 | Prediction API | Get wallet open positions |
| GET | `/v4/data/prediction/wallets/{address}/history` | GetPredictionWalletHistoryV4 | Prediction API | Get wallet closed positions |
| GET | `/v4/data/prediction/wallets/{address}/trades` | GetPredictionWalletTradesV4 | Prediction API | Get wallet trade history |
| GET | `/v4/data/prediction/wallets/{address}/activity` | GetPredictionWalletActivityV4 | Prediction API | Get wallet activity feed |
| GET | `/v4/data/prediction/wallets/{address}/value` | GetPredictionWalletValueV4 | Prediction API | Get wallet open-position notional |
| GET | `/v4/data/prediction/wallets/{address}/markets-traded` | GetPredictionWalletMarketsTradedV4 | Prediction API | Get wallet markets-traded count |
| GET | `/v4/data/prediction/top-traders` | GetPredictionTopTradersV4 | Prediction API | Get top traders leaderboard |
| GET | `/v4/data/prediction/search` | GetPredictionSearchV4 | Prediction API | Unified search (events / tags / profiles) |

## Blockchain Notifications - operations

- Tags: Notifications, Subscriptions, Templates
- Source: <https://docs.tatum.io/openapi/notifications-1.json>

| method | path | operationId | tags | summary |
| --- | --- | --- | --- | --- |
| GET | `/v4/subscription` | getSubscriptionsV4 | Subscriptions | List all active subscriptions |
| POST | `/v4/subscription` | createSubscriptionV4 | Subscriptions | Create a subscription |
| PUT | `/v4/subscription` | enableWebHookHmac | Notifications | Enable HMAC webhook digest |
| DELETE | `/v4/subscription` | disableWebHookHmac | Notifications | Disable HMAC webhook digest |
| GET | `/v4/subscription/count` | getSubscriptionsCount | Subscriptions | Count of subscriptions |
| GET | `/v4/subscription/{id}` | getSubscriptionV4 | Subscriptions | Get subscription by ID |
| PUT | `/v4/subscription/{id}` | updateSubscription | Subscriptions | Update subscription |
| DELETE | `/v4/subscription/{id}` | deleteSubscription | Subscriptions | Cancel existing subscription |
| PUT | `/v4/subscription/batch` | updateSubscriptionsByChain | Subscriptions | Update subscriptions by chain |
| GET | `/v4/subscription/webhook` | getAllWebhooksV4 | Notifications | List all executed webhooks |
| GET | `/v4/subscription/webhook/count` | getAllWebhooksCount | Notifications | Count of found entities for get webhook request |
| POST | `/v4/subscription/webhook/{id}/retry` | retryWebhookV4 | Notifications | Retry a failed webhook |
| GET | `/v4/subscription/template` | getNotificationTemplates | Templates | List all notification templates (V4) |
| POST | `/v4/subscription/template` | createNotificationTemplate | Templates | Create a notification template (V4) |
| GET | `/v4/subscription/template/default` | getDefaultNotificationTemplate | Templates | Get the default notification template |
| PUT | `/v4/subscription/template/default` | updateDefaultNotificationTemplate | Templates | Update the default notification template |
| PUT | `/v4/subscription/template/{id}` | updateNotificationTemplate | Templates | Update notification template (V4) |
| DELETE | `/v4/subscription/template/{id}` | deleteNotificationTemplate | Templates | Delete notification template (V4) |
| POST | `/v3/subscription` | createSubscription | Subscriptions | Create a subscription |

## Machine-readable

- Index: `/api/openapi-index` - <https://ai.tatum.io/api/openapi-index>
- Raw schema: `/openapi/blockchain-data.json` - <https://ai.tatum.io/openapi/blockchain-data.json>
- Raw schema: `/openapi/notifications.json` - <https://ai.tatum.io/openapi/notifications.json>


---

# Authentication

> How AI agents authenticate against Tatum: pass your API key in the x-api-key header on every request. No OAuth flow. Where to store keys for MCP, apps, and CI.

- canonical: <https://ai.tatum.io/auth>
- html: <https://ai.tatum.io/auth>

## API key

Every call carries an API key in the `x-api-key` request header. Get one from the Tatum dashboard.

```http
GET /v4/data/wallet/portfolio?address=0x...&chain=ethereum-mainnet
Host: api.tatum.io
x-api-key: tatum_xxx
```

## Environment variables

- `TATUM_API_KEY` - used by the Tatum MCP server and the Integration Skill.
- Never hardcode the key. Never commit it. Never expose it client-side.

## Where to put it

| Runtime | Location |
| --- | --- |
| Tatum MCP | `env.TATUM_API_KEY` in your MCP client config |
| Backend service | `.env` consumed by your framework |
| CI / CD | Secret store (GitHub Actions, GitLab CI, etc.) |

## Get an API key

Sign up at <https://dashboard.tatum.io>.


---

# Safety

> Operational guidance for AI agents integrating with blockchain infrastructure: read-only APIs, no transaction signing, and human-in-the-loop for any mutations.

- canonical: <https://ai.tatum.io/safety>
- html: <https://ai.tatum.io/safety>

## Defaults

- Read-only first. Reach for write/transaction methods only with explicit human approval.
- Validate every address against the target chain before issuing calls.
- Prefer Notifications over polling - push avoids quota drain and lag.
- Retries: bounded, jittered, idempotent. Never spin on 429.
- Never expose private keys, signing credentials, or API keys to the model.

## Boundaries

**No transaction signing** - This site documents read APIs and gateway access only. Signing is out of scope for agentic flows here.

**Human in the loop** - Any mutating action - webhook deletion, subscription rotation, gateway writes - should require human confirmation.

**Per-chain validation** - EVM, Bitcoin, Solana, Cardano, and others have incompatible address formats. Always check the chain prefix.

## References

- Auth guide: <https://ai.tatum.io/auth>
- MCP page: <https://ai.tatum.io/mcp>
- Workflows: <https://ai.tatum.io/workflows>


---

# RPC Gateway - capability
> Direct JSON-RPC and chain-native protocol access to 130+ networks through a single managed gateway.
- canonical: <https://ai.tatum.io/capabilities/rpc-gateway>
- category: rpc
- risk: low
## Why agents use it
Lets agents query chain state, simulate transactions, and call contracts without operating their own nodes.
## MCP tools

- `gateway_get_supported_chains`
- `gateway_get_supported_methods`
- `gateway_execute_rpc`

## Related workflows

- <https://ai.tatum.io/workflows/rpc-diagnostic-agent>

## Docs

- <https://docs.tatum.io>

## Notes
## Canonical recipe

End-to-end procedure: [RPC Diagnostic Agent](/workflows/rpc-diagnostic-agent). Discover chains, list methods, execute a diagnostic RPC call.

## Risk

Read-only by default. Write methods exist on most chains but must be gated by human approval in agentic flows.

---

# Wallet Portfolio - capability
> Aggregated balances, tokens, and historical positions for any wallet across supported chains.
- canonical: <https://ai.tatum.io/capabilities/wallet-portfolio>
- category: data
- risk: low
## Why agents use it
Lets agents answer "what does this wallet hold?" with one call, instead of crawling chains per-asset.
## MCP tools

- `get_wallet_portfolio`
- `get_wallet_balance_by_time`
- `get_tokens`

## Related workflows

- <https://ai.tatum.io/workflows/wallet-portfolio-assistant>

## OpenAPI references

- `/openapi/blockchain-data.json`, tag `Wallet API`

## Docs

- <https://docs.tatum.io>

## Notes
## Canonical recipe

End-to-end procedure: [Wallet Portfolio Assistant](/workflows/wallet-portfolio-assistant). Validate address, fetch portfolio, optional FX quote.

## Risk

Read-only. No private-key material involved.

---

# Notifications - capability
> Webhook-based subscriptions for incoming transactions, contract events, and chain activity.
- canonical: <https://ai.tatum.io/capabilities/notifications>
- category: notifications
- risk: low
## Why agents use it
Push beats polling. Agents react to chain events without burning RPC quota.
## Related workflows

- <https://ai.tatum.io/workflows/incoming-payment-monitor>

## OpenAPI references

- `/openapi/notifications.json`, tag `Subscriptions`

## Docs

- <https://docs.tatum.io>

## Notes
## Canonical recipe

No MCP tools for subscriptions today. Use the HTTP procedure in [Incoming Payment Monitor](/workflows/incoming-payment-monitor). Create a webhook subscription, verify HMAC signatures, handle events idempotently.

## Risk

Public webhook endpoints must validate the HMAC signature. Idempotency is the agent's responsibility.

---

# NFT Ownership - capability
> Resolve owners of a token, balances per address, and metadata for NFTs and multitokens.
- canonical: <https://ai.tatum.io/capabilities/nft-ownership>
- category: data
- risk: low
## Why agents use it
Lets agents gate access, verify drops, or audit ownership without bespoke indexers.
## MCP tools

- `get_owners`
- `check_owner`
- `get_metadata`

## Related workflows

- <https://ai.tatum.io/workflows/nft-ownership-checker>

## OpenAPI references

- `/openapi/blockchain-data.json`, tag `NFT API`

## Docs

- <https://docs.tatum.io>

## Notes
## Canonical recipe

End-to-end procedure: [NFT Ownership Checker](/workflows/nft-ownership-checker). Resolve contract, check owners, optional metadata.

## Risk

Read-only.

---

# Exchange Rates - capability
> Real-time token and fiat exchange rates across supported chains.
- canonical: <https://ai.tatum.io/capabilities/exchange-rates>
- category: data
- risk: low
## Why agents use it
Convert balances and transaction values into user-facing currencies without integrating a separate price oracle.
## MCP tools

- `get_exchange_rate`

## OpenAPI references

- `/openapi/blockchain-data.json`, tag `Exchange Rates`

## Docs

- <https://docs.tatum.io>

## Notes
## Usage

1. Resolve the asset symbol or contract address.
2. Call `get_exchange_rate` with the target quote currency.

## Risk

Read-only. Cache aggressively for UI uses; never use cached rates for settlement.

---

# Transaction Monitoring - capability
> Address transaction history with filtering, decoding hints, and pagination.
- canonical: <https://ai.tatum.io/capabilities/transaction-monitoring>
- category: data
- risk: low
## Why agents use it
Lets agents reconstruct what happened to an address without scanning blocks.
## MCP tools

- `get_transaction_history`
- `get_block_by_time`

## Related workflows

- <https://ai.tatum.io/workflows/incoming-payment-monitor>

## OpenAPI references

- `/openapi/blockchain-data.json`, tag `Transactions API`

## Docs

- <https://docs.tatum.io>

## Notes
## Canonical recipe

For ongoing monitoring prefer [Incoming Payment Monitor](/workflows/incoming-payment-monitor) (webhooks). For historical reconstruction use `get_transaction_history` via MCP or the Transactions API.

## Risk

Read-only. Be conservative with very wide time ranges on busy chains.

---

# Wallet Portfolio Assistant - workflow
> Answer "what does wallet X hold on chain Y?" in one round trip.
- canonical: <https://ai.tatum.io/workflows/wallet-portfolio-assistant>
## MCP tools

- `get_wallet_portfolio`
- `get_tokens`
- `get_exchange_rate`

## API endpoints

- `GET /v4/data/wallet/portfolio`
- `GET /v4/data/wallet/tokens`

## Steps
1. Parse the user prompt for `address` and `chain`.
2. Validate the address shape for that chain.
3. Call `get_wallet_portfolio` (or the `Wallet API` endpoint).
4. Optionally enrich with `get_exchange_rate` to convert to a user-friendly quote currency.
5. Return a structured summary: native balance, top tokens by value, NFT count.
## Possible failures

- Unsupported chain for the address
- Address checksum invalid for the chain
- Token contract returns malformed metadata

## Recovery guidance

- Validate address against chain rules before calling
- Surface the chain support list from /api/chains when the chain is unknown
- Skip malformed tokens, never fail the whole portfolio call


---

# Incoming Payment Monitor - workflow
> Notify when an address receives a payment, and act on it.
- canonical: <https://ai.tatum.io/workflows/incoming-payment-monitor>
## MCP tools

- `get_transaction_history`

## API endpoints

- `POST /v4/subscription`
- `GET /v4/subscription`
- `DELETE /v4/subscription/{id}`

## Steps
1. Subscribe to incoming transactions for the target address via the Notifications API.
2. Configure the public webhook URL and signing secret.
3. On delivery, verify the HMAC signature, dedupe, and process.
4. Maintain subscription lifecycle (rotate secrets, delete on user opt-out).
## Possible failures

- Webhook endpoint unreachable
- HMAC signature mismatch
- Duplicate webhook delivery

## Recovery guidance

- Tatum retries failed deliveries; ensure 2xx within the retry budget
- Reject unsigned/wrong-signature payloads and alert
- Deduplicate by event id; treat handlers as idempotent


---

# NFT Ownership Checker - workflow
> Verify whether an address holds a token in a given NFT collection.
- canonical: <https://ai.tatum.io/workflows/nft-ownership-checker>
## MCP tools

- `check_owner`
- `get_owners`
- `get_metadata`

## API endpoints

- `GET /v4/data/nft/owners`
- `GET /v4/data/nft/metadata`

## Steps
1. Resolve `contract`, `tokenId`, `chain`, and `address`.
2. Call `check_owner` for the boolean answer.
3. If positive and metadata is requested, call `get_metadata`.
## Possible failures

- Wrong chain for the contract
- Contract not an ERC-721/1155
- Address normalization mismatch

## Recovery guidance

- Validate contract on the requested chain first
- Fall back to `get_owners` if `check_owner` returns ambiguous results
- Always compare addresses checksummed/normalized


---

# RPC Diagnostic Agent - workflow
> Diagnose RPC connectivity, method support, and response health for any chain.
- canonical: <https://ai.tatum.io/workflows/rpc-diagnostic-agent>
## MCP tools

- `gateway_get_supported_chains`
- `gateway_get_supported_methods`
- `gateway_execute_rpc`

## Steps
1. Confirm the chain is supported via `gateway_get_supported_chains`.
2. Confirm the method exists via `gateway_get_supported_methods`.
3. Call `gateway_execute_rpc` and report timing, response code, and any error envelope.
## Possible failures

- Method not supported on the chain
- Rate-limit / quota exhaustion
- Network partition / endpoint downtime

## Recovery guidance

- Confirm the method against `gateway_get_supported_methods` before calling
- Backoff with jitter on 429; never spin
- Re-route via `gateway_execute_rpc` (managed gateway handles failover)