πŸ”‘ Authentication and Free limits

Tatum allows unauthenticated Users to trial test the service offering, to an extent.

Each request has a cost in credits. After consuming a sizeable amount of free credits, unauthenticated requests will receive an error looking as follows or similar:

Error code: 403
{
    You have reached the limit of 10000 credits with your free plan for '####'.
    Upgrade your plan at https://co.tatum.io/3JjG5Ih
}

πŸ“˜

If you have a paid plan and get this error, make sure you are authenticating your requests.

How to authenticate your requests

  1. You need a Tatum Account.
  2. Sign in or create your Tatum Account via the following link.
  3. New Free accounts come with x2 auth API keys:
    • Mainnet
    • Testnet
  4. Authenticate your requests with your API key(s).

Example request - Authenticated:

curl --location 'https://api.tatum.io/v3/dogecoin/address/balance/DTsH7BpHcekmUmaHjUX9eb4Z4CFzCKuY9K' \
--header 'x-api-key: {YOUR_API_KEY}
//response:
{
    "incoming": "0",
    "outgoing": "0",
    "incomingPending": "0",
    "outgoingPending": "0"
}