Skip to main content

​
1. Obtain an API Key

1

Sign Up for a Blockworks Research Account

Log in to your account

Choose your plan and log in to your account
2

Navigate to the API Key Management page

Profile > Account Management > APIAPI Key Management
3

Create a New API Key

Enter a new name for your API key and click “Create Key”.API Key Management
4

Save It Somewhere Safe

Once generated, you won’t be able to access it again. Copy the key to your clipboard and store it securely.API Key Management

​
2. Use Your API Key to Make a Request

Once we have our API key, we can make requests to the API. Here’s a simple example of how to fetch the list of available assets: 
curl -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.blockworks.com/v1/assets

​
Example Response

Most API responses follow a consistent structure, with the data property containing an array of items, a total property indicating the total number of items, and a page property indicating the current page. 
{
  "data": [
    {
      "category": "Infrastructure",
      "code": "ETH",
      "description": "Ethereum is a distributed blockchain computing platform for smart...",
      "id": 2,
      "image_url": "https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628",
      "is_supported": true,
      "is_supported": true,
      "legacy_sector": "Smart Contract Platforms",
      "sector_id": 40,
      "slug": "ethereum",
      "tag_line": "A decentralized computing platform",
      "title": "Ethereum",
      "type": "Infrastructure",
      "updated_at": 1747346559
    },
    ... // more assets
  ],
  "total": 12,
  "page": 1
}
That’s it!