Server Configuration
Describes the environment variables required to run the server.
Name | Required | Description | Default |
---|---|---|---|
TATUM_API_KEY | Yes | Your Tatum API key. Get a free key at: https://dashboard.tatum.io |
Schema
Prompts
Interactive templates invoked by user choice
Name | Description |
---|---|
No prompts |
Resources
Contextual data attached and managed by the client
Name | Description |
---|---|
No resources |
Tools
Functions exposed to the LLM to take actions
Name | Description |
---|---|
get_collections_v4 | [blockchain_data] /v4/data/collections 20 credits per API call > 📘 Note for v3 API users: > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/collections. Users can refer to GET /v4/data/collections for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Get all NFTs (ERC-721 and ERC-1155) and multitokens (ERC-1155 only) of your favorite collections! Our API lets you search for all tokens on: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of collection addresses. Our API will return relevant information about each token, including its name, description, image, and more. Aside from relevant information about each token, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns results for all supported types of tokens (nft, multitokens), but you can also choose to filter only one tokenType. For Tezos blockchain query parameters excludeMetadata and tokenType won't have any effect on filtering data. |
get_metadata_v4 | [blockchain_data] /v4/data/metadata 10 credits per API call > 📘 Note for v3 API users: > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/metadata. Users can refer to GET /v4/data/metadata for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Get metadata of NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) by IDs for a given token address! Our API lets you search for all tokens on: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet To get started: Provide a chain name, token address and comma-separated list of IDs. Our API will return relevant metadata about each specified token, including its name, description, image, and more. Aside from the metadata information, the response also contains token types and metadata url minted in each token. |
get_wallet_balance_by_time_v4 | [blockchain_data] /v4/data/wallet/balance/time 100 credits per API call Get native balances for a specific wallet addresses by time on the following blockchains: Ethereum - ethereum-mainnet Bitcoin - bitcoin-mainnet Base - base-mainnet Arbitrum - arb-one-mainnet BSC - bsc-mainnet Polygon - polygon-mainnet Optimism - optimism-mainnet Celo - celo-mainnet To get started, provide a chain name, comma-separated list of addresses and specify one of the filters listed below (combination of the filters is not allowed): block number time unix If you pass a block number that is in the future (beyond the current latest block), the system will return the balance for the latest block. If you pass a time or Unix timestamp that is in the future, the system will also return the balance for the latest block. If you pass a time or Unix timestamp in the past (dating back to or earlier than the blockchain's genesis block), the system will return the balance for the first block (genesis block). |
get_wallet_balances_v4 | [blockchain_data] /v4/data/wallet/balances 50 credits per API call This endpoint is deprecated. > 📘 Note: > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/wallet/portfolio. As a result, the older endpoint - GET /v4/data/wallet/balances - has been deprecated. These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible. Get balances of native, fungible tokens (ERC-20), NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of addresses. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns balances for all supported types of tokens (native, fungible tokens, nft, multitokens), but you can also choose to filter specific tokenTypes. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata. |
get_wallet_portfolio_v4 | [blockchain_data] /v4/data/wallet/portfolio 50 credits per API call Get portfolio balances of native, fungible tokens (ERC-20) or NFTs (ERC-721 and ERC-1155) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Solana - solana-mainnet / solana-devnet Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and and an address of that chain. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). The API requires specifying the tokenTypes parameter to indicate which types of tokens to fetch balances for. Supported values include [native], [fungible] and [nft,multitoken]. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata. |
get_balances_v4 | [blockchain_data] /v4/data/balances 50 credits per API call This endpoint is deprecated. > 📘 Note: > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/wallet/portfolio. As a result, the older endpoints - GET /v3/data/balances & GET /v4/data/balances - have been deprecated. These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible. Get balances of fungible tokens (ERC-20), NFTs (ERC-721 and ERC-1155) or multitokens (ERC-1155 only) for a specific wallet address on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet Tezos - tezos-mainnet To get started: Provide a chain name and comma-separated list of addresses. Our API will return balances of each token along with further information such as its type, id, and more. Aside from relevant information about each token and its balance, the response also contains metadata (they can, however, be excluded by setting excludeMetadata to true). If not specified, the API returns balances for all supported types of tokens (fungible tokens, nft, multitokens), but you can also choose to filter specific tokenTypes. For Tezos blockchain, the API returns balance of any tokens including native token (XTZ) for specified wallet addresses. Following query parameters won't have any effect on filtering data excludeMetadata. |
get_owners_v4 | [blockchain_data] /v4/data/owners 50 credits per API call > 📘 Note for v3 API users: > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/owners. Users can refer to GET /v4/data/owners for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Get all addresses that own your favorite token (ERC-20, ERC-721 or ERC-1155)! Our API lets you search for all token owners on: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet To get started: Provide a chain name and address of any fungible token, NFT or multitoken collection. Our API will return a list of addresses of all of their owners. You can also get an owner of a specific NFT by specifying tokenId. In case of multitoken, result is an array of addresses. |
check_owner_v4 | [blockchain_data] /v4/data/owners/address 50 credit per API call > 📘 Note for v3 API users: > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/owners/address. Users can refer to GET /v4/data/owners/address for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version. Check if wallet address owns any specified token (ERC-20, ERC-721 or ERC-1155) on the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Chiliz - chiliz-mainnet To get started: Provide a chain name, wallet address and address of any fungible token, NFT or multitoken collection. Our API will return true if provided wallet address owns them. If wallet address does not own the specific token, response body is false and status code is 200. It is also possible to check if wallet address owns a specific NFT by specifying a tokenId. |
get_nft_balances_v4 | [blockchain_data] /v4/data/nft/balances 50 credits per API call Get all NFTs that a blockchain address holds. The NFTs are returned grouped by the smart contracts they were minted on. This API is supported for the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Solana - solana-mainnet / solana-devnet Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Algorand - algorand-mainnet-algod / algorand-testnet-algod On Solana and Algorand, if a blockchain address holds fewer than 50 NFTs, the API also returns each NFT's metadata. If the metadata is not returned, you can obtain it using the API for getting NFT metadata. |
get_multi_token_balance_v4 | [blockchain_data] /v4/data/multitoken/balances 50 credits per API call Get Multi Token balances of a wallet address. The Multi Tokens are returned grouped by the smart contracts they were minted on. This API is supported for the following blockchains: Ethereum - ethereum-mainnet / ethereum-sepolia / ethereum-holesky Base - base-mainnet / base-sepolia Arbitrum - arb-one-mainnet / arb-testnet Polygon - polygon-mainnet / polygon-amoy Optimism - optimism-mainnet / optimism-testnet Celo - celo-mainnet / celo-testnet Algorand - algorand-mainnet-algod / algorand-testnet-algod |
estimate_gas | [fee_estimation] 10 credits per API call Get an estimated gas price (wei) and the number of gas units needed for a transaction. New endpoint which is unifying all supported chains for gas estimation into the one. List of supported chains is bellow. BNB Smart Chain (BSC) Celo (CELO) Elrond (EGLD) Ethereum (ETH) Harmony (ONE) Klaytn (KLAY) KuCoin Community Chain (KCS) Flare (FLR) Cronos (CRO) Avalanche (AVAX) Base (BASE) Polygon (POL_ETH) Optimism (OPTIMISM) Fantom (FTM) Sonic (S) |
get_blockchain_fee | [fee_estimation] 1 credit per API call Get the recommended fee/gas price for a blockchain. Fee is in satoshis(meaning currency(BTC, DOGE,... / 100 000 000) per byte This API is supported for the following blockchains: Bitcoin Dogecoin Ethereum Litecoin |
estimate_fee_blockchain | [fee_estimation] 10 credits per API call Estimate the current fee for different types of transactions. This API is supported for the following blockchains: Bitcoin BNB Smart Chain Celo Dogecoin Ethereum Harmony Klaytn Litecoin Polygon XinFin |
bsc_estimate_gas | [fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a BNB Smart Chain transaction. The gas price is obtained from https://explorer.bitquery.io/bsc/gas. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction. |
celo_estimate_gas | [fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a Celo transaction. The gas price is obtained from https://explorer.bitquery.io/celo_rc1/gas. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction. |
egld_estimate_gas | [fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for an Elrond transaction. The gas price is obtained from https://gateway.elrond.com/network/config. The gas limit is obtains from https://gateway.elrond.com/transaction/cost. |
eth_estimate_gas | [fee_estimation] 10 credits per API call Get an estimated gas price and the number of gas units needed for an Ethereum transaction. The gas price is obtained from multiple sources and calculated based on the latest N blocks and the current mempool state. The fast gas price is used by default. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction. |
eth_estimate_gas_batch | [fee_estimation] 10 credits per API call + 10 credits per each gas estimation Get an estimated gas price and the number of gas units needed for multiple Ethereum transactions. The gas price is obtained from multiple sources and calculated based on the latest N blocks and the current mempool state. The estimations are returned in the same order as the transactions were submitted in the request. The fast gas price is used by default. NOTE: The estimated gas price is returned in wei. However, when making a transaction itself and providing the custom fee, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction. |
one_estimate_gas | [fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a Harmony transaction. NOTE: The estimated gas price is returned in wei. However, when making the transaction itself, you have to provide the gas price in Gwei. Make sure to convert the estimated gas price from wei to Gwei before submitting your transaction. |
klaytn_estimate_gas | [fee_estimation] 2 credits per API call Get an estimated gas price and the number of gas units needed for a Klaytn transaction. The gas price is obtained from https://explorer.bitquery.io/klaytn/gas. NOTE: The estimated gas price is returned in peb. However, when making the transaction itself and providing the custom fee, you have to provide the gas price in Gpeb. Make sure to convert the estimated gas price from peb to Gpeb before submitting your transaction. |
gateway_get_supported_chains | [gateway] Get a list of all supported blockchain chains available through Tatum's RPC gateways |
gateway_get_evm_chains | [gateway] Get a list of EVM-compatible blockchain chains available through Tatum's RPC gateways |
gateway_get_url | [gateway] Get the RPC gateway URL for a specific blockchain chain |
gateway_is_evm_chain | [gateway] Check if a specific blockchain chain is EVM-compatible |
gateway_execute_rpc | [gateway] Execute an RPC call to a specific blockchain through Tatum's gateway |
gateway_get_supported_chains | [gateway] Get a list of all supported blockchain chains |
gateway_get_evm_chains | [gateway] Get a list of all supported EVM-compatible chains |
gateway_get_url | [gateway] Get the gateway URL for a specific chain |
gateway_is_evm_chain | [gateway] Check if a chain is EVM-compatible |
gateway_execute_rpc | [gateway] Execute an RPC call on a specific chain |
get_available_tools | [gateway] Get a list of all available tools and their capabilities |