πŸ”‘ Authentication

When using the Tatum API or SDK, you authenticate yourself with an API key.

Access our services securely by authenticating with your Tatum account through available methods listed below, ensuring a secure and personalized experience. While it is possible to connect without authentication, please note that this approach provides limited access and functionalities.

To obtain the API key, create a Tatum account. Once you are signed into the Dashboard, you are automatically assigned the Free plan.

The API key represents your pricing plan and defines how many API calls you can make per second and what the total number of API calls per month is available for you.

Get API key For free. No commitment.

Don't have an API key?

Sign up to Dashboard and create your API keys today.
Get higher limits and use debugging tools.

Auth API Keys: Mainnet vs Testnet

When you sign up in the Tatum.io Dashboard, you'll get one development (Testnet) Auth API key and one for production (Mainnet) API key. You can create more API keys as you need them.

  • Mainnet stands for "main network". This is where your production app will run.
  • Testnet stands for "testing network". In most cases, has the same features and characteristics as the mainnet. The Testnet blockchain is completely isolated from the Mainnet blockchain. It doesn't have the same data, and it doesn't guarantee data persistence. On the other hand, all operations on the Testnet are free. This makes Testnet a great environment for developing and testing apps.

🚧

All Mainnet transactions are final. If you send assets like BTC to the wrong address over Testnet it's fine since Testnet assets hold no value. However, if this happens in Mainnet, you'll lose real money!

X-API-Key in header

curl --location 'https://api.tatum.io/v3/blockchain/node/<CHAIN>-<MAINNET/TESTNET>'
--header 'Content-Type: application/json' 
--header 'x-api-key:<YOUR-API-KEY>' 
--data '{
    "jsonrpc":"2.0",
    "method":"web3_clientVersion",
    "params":[],
    "id":1
}'
const tatum = await TatumSDK.init<Ethereum>({
  network: Network.ETHEREUM,
  apiKey: {
   v4: 'YOUR_API_KEY_V4'
})

API Key in the SDK

import { TatumSDK, Ethereum, Network } from '@tatumio/tatum'

const tatum = await TatumSDK.init<Ethereum>({
    network: Network.ETHEREUM, 
    apiKey: { v4: 'YOU-API-KEY'}
    }
)