Authentication

The Tokenomist API authenticates every request with an API key sent in a request header. All requests must be made over HTTPS.

Don’t have a key yet? See Setting up your API key.

Base URL

https://api.tokenomist.ai

The previous domain https://api.unlocks.app still works, but we recommend updating integrations to https://api.tokenomist.ai.

Authenticating a request

Send your key in the x-api-key header on every request:

curl https://api.tokenomist.ai/v5/token/list \
  -H "x-api-key: YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.tokenomist.ai/v5/token/list",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(resp.json())

const resp = await fetch("https://api.tokenomist.ai/v5/token/list", {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await resp.json();

Keep your API key server-side. Don’t embed it in client-side code or expose it in URLs, logs, or browser history.

Failed authentication

Requests with a missing or invalid key are rejected with 401 Unauthorized and are not counted against your quota. See Rate limits, quotas & errors for the full error reference.

The quota state returned in metadata.credit only appears on authenticated requests. Unauthenticated requests do not include it.

Setting up your API key

Rate limits, quotas & errors

Get started

Core concepts

Token List

Allocations

Daily Emission

Unlock Events

Fundraising

Burn

Buyback

Deprecated versions

Base URL

Authenticating a request

Failed authentication

​Base URL

​Authenticating a request

​Failed authentication

Base URL

Authenticating a request

Failed authentication