Skip to main content
The Tokenomics Analyzer provides comprehensive token supply analysis, unlock schedules, and allocation data for 200+ tokens.

​
Pricing

Each request costs $0.02 USD (paid via x402 on Base Sepolia testnet).

​
Analyze Tokenomics

Get comprehensive tokenomics data including supply, unlock events, and allocation breakdown.
GET /api/x402/tokenomics/analyze
curl "https://api.arcana.markets/api/x402/tokenomics/analyze?symbol=ARB" \
  -H "Authorization: Bearer YOUR_X402_TOKEN"

​
Query Parameters

​
symbol
string
default:"ARB"
Token symbol (e.g., ARB, OP, SUI, APT, TIA, STRK)

​
Response

​
success
boolean
Whether the request succeeded
​
data
object
​
symbol
string
Token symbol (uppercase)
​
name
string
Full token name
​
supply
object
​
circulating
number
Current circulating supply
​
total
number
Total supply
​
max
number | null
Maximum supply (null if unlimited)
​
circulatingFormatted
string
Human-readable circulating (e.g., “1.23B”)
​
totalFormatted
string
Human-readable total
​
maxFormatted
string | null
Human-readable max supply
​
percentUnlocked
number
Percentage of total supply in circulation
​
nextUnlock
object | null
Next scheduled unlock event
​
date
string
ISO 8601 date (YYYY-MM-DD)
​
amount
number
Tokens to be unlocked
​
amountFormatted
string
Human-readable amount
​
percentOfCirculating
number
Unlock size as % of circulating supply
​
recipient
string
Who receives the unlock (e.g., “Team”, “Investors”)
​
riskLevel
string
Impact assessment (🟢 MINIMAL, 🟡 LOW, 🟠 MEDIUM, 🔴 HIGH)
​
upcomingUnlocks
array
Next 5 unlock events (same structure as nextUnlock)
​
allocations
array
Token allocation breakdown
​
category
string
Allocation category (e.g., “DAO Treasury”, “Team”, “Investors”)
​
percentage
number
Percentage of total supply
​
amount
number
Number of tokens (if available)
​
amountFormatted
string
Human-readable amount
​
inflation
object
​
annualRate
string
Estimated annual inflation rate
​
fullyDilutedBy
string | null
Estimated year when fully diluted (e.g., “~2028”)
​
fetchedAt
string
ISO 8601 timestamp
​
payment
object
x402 payment receipt
{
  "success": true,
  "data": {
    "symbol": "ARB",
    "name": "Arbitrum",
    "supply": {
      "circulating": 3270000000,
      "total": 10000000000,
      "max": 10000000000,
      "circulatingFormatted": "3.27B",
      "totalFormatted": "10.00B",
      "maxFormatted": "10.00B",
      "percentUnlocked": 32.7
    },
    "nextUnlock": {
      "date": "2026-03-16",
      "amount": 85000000,
      "amountFormatted": "85.00M",
      "percentOfCirculating": 2.6,
      "recipient": "Team & Advisors: 45M, Investors: 40M",
      "riskLevel": "🟠 MEDIUM - Noticeable selling pressure likely"
    },
    "upcomingUnlocks": [
      {
        "date": "2026-03-16",
        "amount": 85000000,
        "amountFormatted": "85.00M",
        "percentOfCirculating": 2.6,
        "recipient": "Team & Advisors: 45M, Investors: 40M",
        "riskLevel": "🟠 MEDIUM - Noticeable selling pressure likely"
      },
      {
        "date": "2026-04-16",
        "amount": 72000000,
        "amountFormatted": "72.00M",
        "percentOfCirculating": 2.2,
        "recipient": "Team & Advisors",
        "riskLevel": "🟠 MEDIUM - Noticeable selling pressure likely"
      }
    ],
    "allocations": [
      {
        "category": "DAO Treasury",
        "percentage": 42.78
      },
      {
        "category": "Team & Advisors",
        "percentage": 26.94
      },
      {
        "category": "Investors",
        "percentage": 17.53
      },
      {
        "category": "Community (Airdrop)",
        "percentage": 11.62
      }
    ],
    "inflation": {
      "annualRate": "~13.7%",
      "fullyDilutedBy": "~2028"
    },
    "fetchedAt": "2026-03-03T12:00:00.000Z"
  },
  "payment": { /* x402 receipt */ }
}

​
Unlock Risk Levels

Unlock events are assessed based on their impact on circulating supply:

​
🟢 MINIMAL (< 0.5%)

Negligible impact on price. Typical monthly vesting for mature tokens.

​
🟡 LOW (0.5% - 2%)

Minor supply increase. May cause temporary price dip.

​
🟠 MEDIUM (2% - 5%)

Noticeable selling pressure likely. Significant unlock event.

​
🔴 HIGH (> 5%)

Major unlock with high sell pressure risk. Often seen with:
  • Initial investor unlocks
  • Team cliff unlocks
  • Large DAO treasury releases

​
Supported Tokens

The Tokenomics Analyzer supports 200+ tokens including:

​
Layer 2 Tokens

ARB, OP, STRK, ZK, METIS, IMX, MATIC (POL)

​
New Layer 1s

SUI, APT, SEI, TIA, HYPE, MON

​
DeFi Protocols

AAVE, UNI, CRV, MKR, COMP, SNX, LDO, PENDLE

​
AI & Data

TAO, FET, AGIX, VIRTUAL, RENDER, GRT

​
Meme Coins

PEPE, SHIB, DOGE, FLOKI, BONK, WIF
For full list of supported tokens, see the TOKEN_MAPPINGS in the source code.

​
Data Sources

  • Supply Data: CoinGecko API (circulating, total, max supply)
  • Vesting Schedules: Mobula API (unlock events, allocation data)
  • Hardcoded Data: Curated allocations for major tokens (ARB, OP, SUI, APT, etc.)

​
x402 Payment Flow

All Tokenomics Analyzer requests require payment via x402:
  • Price: $0.02 per request (2x oracle price due to data complexity)
  • Network: Base Sepolia (eip155:84532)
  • Seller Address: 0xc99A4f20E7433d0B6fB48ca805Ffebe989e48Ca6
Tokenomics data combines real-time supply metrics with vetted allocation data to provide the most accurate unlock analysis available.

Build docs developers (and LLMs) love

Get started for freeTalk to us