# AI.tatum.io - full content index

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

Snapshot: 2026-10-02T14:36:14.636Z
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: 67
- Networks: 135
- MCP tools: 13
- OpenAPI operations: 129
- Snapshot at: 2026-10-02T14:36:14.636Z

## 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 every supported network — 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 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>

## Skills.md

## Install

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

Invoke with `/tatum <goal>` in Cursor, Claude Code, or OpenHands.

## Resources

- Install: `npx skills add https://github.com/tatumio/tatum-integration-skill --skill tatum`
- [API key](https://ai.tatum.io/auth)
- [GitHub](https://github.com/tatumio/tatum-integration-skill)

## Ask for it in plain English

One line in the composer. The skill handles the rest, from route to response.

**BALANCES** - /tatum add balance checking for Ethereum

**NOTIFICATIONS** - /tatum add a webhook for Bitcoin transactions

**NFTS** - /tatum add NFT balance checking

**MARKET DATA** - /tatum add 30 day daily chart for ETH/USD

## One request in, repo-native code out

The skill inspects the app, adds the integration, wires configuration, and validates the result against current Tatum context.

**Detect: Framework auto-detection** - Reads your repo shape before it writes anything.

**Generate: Service & route code generation** - Adds the service layer and HTTP route in the style your app already uses.

**Install: Automatic dependency installation** - Installs the SDK and supporting packages only when they are missing.

**Configure: .env configuration with Tatum API key** - Creates the environment contract for a Tatum key without hardcoding secrets.

**Target: V4 endpoints (latest, non-deprecated)** - Targets the current Tatum API surface instead of deprecated endpoints.

**Validate: MCP-assisted parameter & response validation** - Checks parameters and responses against MCP context before you ship.

## Six languages, eighteen frameworks

| Language | Frameworks | Count |
| --- | --- | --- |
| JavaScript / TypeScript | Express, NestJS, Fastify, Koa | 4 |
| Python | FastAPI, Django, Flask | 3 |
| Java | Spring Boot, Quarkus, Micronaut | 3 |
| PHP | Laravel, Symfony, Slim | 3 |
| Go | Gin, Echo, Chi | 3 |
| Ruby | Rails, Sinatra | 2 |


---

# Blockchain Registry

> 67 chains and 135 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: 67
- Networks: 135
- Endpoints (chain x network x interface): 194
- Source: <https://blockchains.tatum.io/blockchains2.json>
- Snapshot: 2026-10-02T14:36:14.636Z

## 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> |
| Casper | Testnet (testnet) | JSON-RPC | json-rpc | <https://casper-testnet.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 | 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 | Mainnet | WebSocket | websocket | <wss://ethereum-mainnet.gateway.tatum.io> |
| 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 | Sepolia (testnet) | WebSocket | websocket | <wss://ethereum-sepolia.gateway.tatum.io> |
| 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> |
| 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> |
| 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> |
| 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 | 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> |
| 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 | Mainnet | JSON-RPC | json-rpc | <https://polygon-mainnet-bor.gateway.tatum.io> |
| Polygon | Mainnet | WebSocket | websocket | <wss://polygon-mainnet.gateway.tatum.io> |
| Polygon | Amoy (testnet) | JSON-RPC | json-rpc | <https://polygon-amoy.gateway.tatum.io> |
| Polygon | Amoy (testnet) | JSON-RPC | json-rpc | <https://polygon-amoy-bor.gateway.tatum.io> |
| Polygon | Amoy (testnet) | WebSocket | websocket | <wss://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> |
| Robinhood | Mainnet | JSON-RPC | json-rpc | <https://robinhood-mainnet.gateway.tatum.io> |
| Robinhood | Mainnet | WebSocket | websocket | <wss://robinhood-mainnet.gateway.tatum.io> |
| Robinhood | Testnet (testnet) | JSON-RPC | json-rpc | <https://robinhood-testnet.gateway.tatum.io> |
| Robinhood | Testnet (testnet) | WebSocket | websocket | <wss://robinhood-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 | Mainnet | WebSocket | websocket | <wss://solana-mainnet.gateway.tatum.io> |
| Solana | Devnet (testnet) | JSON-RPC | json-rpc | <https://solana-devnet.gateway.tatum.io> |
| Solana | Devnet (testnet) | WebSocket | websocket | <wss://solana-devnet.gateway.tatum.io> |
| Sonic | Mainnet | JSON-RPC | json-rpc | <https://sonic-mainnet.gateway.tatum.io> |
| Sonic | Testnet (testnet) | JSON-RPC | json-rpc | <https://sonic-testnet.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) | gRPC | gRPC | <https://sui-testnet-grpc.gateway.tatum.io> |
| Sui | Devnet (testnet) | gRPC | gRPC | <https://sui-devnet-grpc.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 | 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) | 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 129 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 | 109 | 110 | 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, Marketplace, Mining API, NFT API, Prediction API, Security 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 | Security API | 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` | GetPredictionEvents | Prediction API | List prediction-market events |
| GET | `/v4/data/prediction/events/{id}` | GetPredictionEventById | Prediction API | Get a prediction-market event by ID |
| GET | `/v4/data/prediction/markets` | GetPredictionMarkets | Prediction API | List prediction markets |
| GET | `/v4/data/prediction/markets/{id}` | GetPredictionMarketById | Prediction API | Get a prediction market by ID |
| GET | `/v4/data/prediction/markets/{id}/price` | GetPredictionMarketPrice | Prediction API | Get current market price |
| GET | `/v4/data/prediction/markets/{id}/orderbook` | GetPredictionMarketOrderbook | Prediction API | Get current market orderbook |
| GET | `/v4/data/prediction/markets/{id}/history` | GetPredictionMarketPriceHistory | Prediction API | Get market price history |
| GET | `/v4/data/prediction/markets/{id}/trades` | GetPredictionMarketTrades | Prediction API | Get recent market trades |
| GET | `/v4/data/prediction/markets/{id}/positions` | GetPredictionMarketPositions | Prediction API | Get top holders of a market |
| GET | `/v4/data/prediction/wallets/{address}/portfolio` | GetPredictionWalletPortfolio | Prediction API | Get wallet portfolio summary |
| GET | `/v4/data/prediction/wallets/{address}/positions` | GetPredictionWalletPositions | Prediction API | Get wallet open positions |
| GET | `/v4/data/prediction/wallets/{address}/history` | GetPredictionWalletHistory | Prediction API | Get wallet closed positions |
| GET | `/v4/data/prediction/wallets/{address}/trades` | GetPredictionWalletTrades | Prediction API | Get wallet trade history |
| GET | `/v4/data/prediction/wallets/{address}/activity` | GetPredictionWalletActivity | Prediction API | Get wallet activity feed |
| GET | `/v4/data/prediction/wallets/{address}/value` | GetPredictionWalletValue | Prediction API | Get wallet open-position notional |
| GET | `/v4/data/prediction/wallets/{address}/markets-traded` | GetPredictionWalletMarketsTraded | Prediction API | Get wallet markets-traded count |
| GET | `/v4/data/prediction/top-traders` | GetPredictionTopTraders | Prediction API | Get top traders leaderboard |
| GET | `/v4/data/prediction/search` | GetPredictionSearch | Prediction API | Unified search (events / tags / profiles) |
| GET | `/v4/data/security/contract/risk` | CheckContractRiskV4 | Security API | Analyze contract risk |
| POST | `/v4/data/security/transaction/simulate` | SimulateTransactionV4 | Security API | Simulate a transaction with risk analysis |
| POST | `/v4/data/security/domain/check` | CheckDomainV4 | Security API | Check a domain for phishing |

## 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 alerts |
| POST | `/v4/subscription` | createSubscriptionV4 | Subscriptions | Create an alert |
| 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 alerts |
| GET | `/v4/subscription/{id}` | getSubscriptionV4 | Subscriptions | Get alert by ID |
| PUT | `/v4/subscription/{id}` | updateSubscription | Subscriptions | Update alert |
| DELETE | `/v4/subscription/{id}` | deleteSubscription | Subscriptions | Cancel existing alert |
| PUT | `/v4/subscription/batch` | updateSubscriptionsByChain | Subscriptions | Update alerts 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 an alert |

## 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
```

## Where the key lives

Read `TATUM_API_KEY` from the environment everywhere. Never commit it, and never put it in client-side code.

| Surface | Location | Note |
| --- | --- | --- |
| Blockchain MCP | env in your MCP client JSON | Lives in the editor config, never in the repo. |
| Backend app | .env or a secret manager | Server side only. The key is not public. |
| CI | GitHub Actions · GitLab · Vercel · Cloudflare | One key per environment, so you can rotate one at a time. |
| Local shell | export TATUM_API_KEY=… | Fine for scratch work. Rotate the key when you are done. |

## Check it in one call

A JSON body means the key works. A 401 means the header is missing or wrong. A 429 means the request was rate limited.

```bash
curl -s -H "x-api-key: $TATUM_API_KEY" \
  "https://api.tatum.io/v4/data/exchange-rate?currency=ETH&basePair=USD"
```

- 200 — The key works: A JSON body comes back. Nothing else to do.
- 401 — Header missing or wrong: Check the spelling of x-api-key and that the variable resolved.
- 429 — Rate limited: Back off and retry. Do not hammer the API in a loop.


---

# Safety

> Operational guidance for agents wired into blockchain infrastructure. Read APIs by default, no transaction signing, and a human confirmation for anything that changes state.

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

## Defaults

- Query before you act. Use inspect tools before anything that moves funds or changes state.
- Check the address format. The wrong chain usually returns empty data, not an error.
- Prefer webhooks to polling. Subscribe to events instead of calling RPC or REST in a loop.
- Limit retries. A 429 is a signal to wait, not to try harder.
- Private keys and API keys stay in the environment and never enter the model context.

## Boundaries

**No transaction signing** - These pages document read APIs and gateway access. Transaction signing belongs in your wallet, KMS, or signer.

**Human in the loop** - Deleting webhooks, rotating keys, and gateway writes all need 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)