Skip to main content
GET
/
v5
/
allocations
/
{tokenId}
Allocations v5
curl --request GET \
  --url https://api.tokenomist.ai/v5/allocations/{tokenId} \
  --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
      }
    ]
  }
}
v5 update: Token identifier moves from a query param (?tokenId=...) to a path param (/v5/allocations/{tokenId}).

Authorizations

​
x-api-key
string
header
required

Your Tokenomist API key

Path Parameters

​
tokenId
string
required

Token identifier (slug). Get from Token List API.

Response

200 - application/json

Successful response

​
metadata
object
​
status
boolean
​
data
object