Authentication

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

1. Get an API Key

Sign up at app.blockdaemon.com to create an account and generate your DeFi 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"
  }
}

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.