Skip to main content
GET
/
v2
/
allocations
Allocations v2
curl --request GET \
  --url https://api.tokenomist.ai/v2/allocations \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "name": "Optimism",
    "symbol": "OP",
    "listedMethod": "INTERNAL",
    "maxSupply": 4294967296,
    "lastUpdatedDate": "2025-06-11T10:36:43Z",
    "totalUnlockedAmount": 1930591949.2000003,
    "totalLockedAmount": 274658779,
    "totalUntrackedAmount": 0.8000006675720215,
    "totalTBDLockedAmount": 2089716567,
    "allocations": [
      {
        "allocationName": "Core Contributors",
        "allocationType": "Scheduled",
        "standardAllocationName": "Founder / Team",
        "allocationUnlockedAmount": 716795218,
        "allocationLockedAmount": 99248568,
        "allocationAmount": 816043786,
        "trackedAllocationPercentage": 18.999999998835847
      }
    ]
  }
}
v2 update: Add Dynamic inflation rate. value might differ to v1 v2 update: Provides more tokens that are listed with AI method. Add more field about listing method, see below for field description
Listing MethodDefinition
INTERNALThis token is listed and verified and cross checked across multiple sources by tokenomist
AIThis token has been listed using LLM assisted with single source.
EXTERNALThis token is listed directly by the project team. It is first-party data and comes solely from the project’s own source.

Authorizations

​
x-api-key
string
header
required

Your Tokenomist API key

Query Parameters

​
tokenId
string
required

Token identifier. Get from Token List API.

Response

200 - application/json

Successful response

​
metadata
object
​
status
boolean
​
data
object