Build with structured token data before running your own indexers.

TokenAPI is designed as a clean API layer for token profiles, market snapshots, holder signals, webhook alerts, and product-ready crypto data workflows.

Authentication

Use a bearer token for every request.

API keys will be issued per workspace. Keep live keys server-side and use separate keys for production, staging, and local testing.

Authorization: Bearer tk_live_your_workspace_key
Content-Type: application/json

Core endpoints

Start with four product-facing surfaces.

GETGET /v1/tokens/{chain}/{address}

Token profile

Return normalized metadata, contract details, socials, and verification notes.

GETGET /v1/markets/snapshot

Market snapshot

Return price, liquidity, volume, market cap, and short-window movement.

GETGET /v1/signals/holders

Holder signals

Return ownership concentration, top holder ranges, and transfer velocity.

POSTPOST /v1/webhooks

Webhook subscription

Example request

Fetch a token profile by chain and contract.

curl https://api.tokenapi.biz/v1/tokens/base/0xabc...   -H "Authorization: Bearer tk_live_your_workspace_key"

Example response

Responses are normalized for UI rendering, search indexing, and agent context.

{
  "chain": "base",
  "address": "0xabc...",
  "symbol": "TOKEN",
  "name": "Example Token",
  "decimals": 18,
  "market": {
    "priceUsd": "1.28",
    "liquidityUsd": "8400000",
    "volume24hUsd": "1150000"
  },
  "risk": {
    "status": "verified",
    "notes": ["contract verified"]
  }
}

Rate limits

Rate limits scale by plan.

Starter keys are intended for prototypes. Developer and Enterprise keys unlock higher throughput, webhook delivery, and priority support.

Starter: 1,000 requests per month
Developer: 250k requests per month
Enterprise: custom quotas and SLA options

Error responses

Errors are predictable and machine-readable.

400bad_request

The request is missing a required chain, address, or parameter.

401unauthorized

The API key is missing, expired, or malformed.

404not_found

The token or chain could not be resolved.

429rate_limited

The workspace exceeded its current request quota.

Launch status

The docs are ready for early access conversations.

This page defines the developer promise before the live backend is connected. The next production step is to connect an API-key request form, store leads, and wire the first real data provider.

Request API Access