Authentication

The API uses API keys for authentication. First, you need to get an API key.

1. Get an API Key

Need a DeFI API key?

Interact with a variety of DeFi protocols across many Blockchains through a uniform and consistent API

2. Authenticate Requests

Method 1: As a Query Parameter

Add your API key to the request URL using ?apiKey=YOUR_API_KEY.

curl "https://svc.blockdaemon.com/tokens/v1?apiKey=YOUR_API_KEY"

You can use this method with any tool without needing extra steps. Note that if the URL already has other parameters, replace ? with &.

Method 2: As a Bearer Token

Use the Authorization header with your API key as a bearer token.

curl -X GET "https://svc.blockdaemon.com/tokens/v1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Method 3: As an X-API-Key Header

Add your API key using the X-API-Key header.

curl -X GET "https://svc.blockdaemon.com/tokens/v1" \
  -H "X-API-Key: YOUR_API_KEY"

3. Test Your API Key

You can try to validate your key by calling the /tokens/v1 endpoint:

curl -X GET "https://svc.blockdaemon.com/tokens/v1" \
  -H "X-API-Key: YOUR_API_KEY" | jq

✅ A successful response returns supported token metadata:

[
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "chainID": "eip155:1",
      "decimals": 6,
      "extensions": {
        "homepage": "https://www.circle.com/en/usdc",
        "verified": true
      },
      "logoURI": "https://defi-images-blockdaemon-research-development-int-aa593eebdaa2fd.gitlab.io/tokens/1-0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.webp",
      "name": "USDC",
      "priceUSD": 0.999737,
      "symbol": "USDC",
      "tags": [
        "stargateV2",
        "stargateV1",
        "stablecoin"
      ]
    }
]

❌ If your API key is invalid or missing, you'll get an error response below:

{
  "type": "https://httpproblems.com/http-status/401",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Authorization Failed",
  "instance": "/defi/chains",
  "trace": {
    "timestamp": "2024-04-30T10:30:30.874Z",
    "requestId": "0b05fee3-b980-4655-a992-5c26f9192edd"
  }
}