Skip to main content
GET
/
v1
/
allocations
Allocations v1
curl --request GET \
  --url https://api.tokenomist.ai/v1/allocations \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "name": "Optimism",
    "symbol": "OP",
    "maxSupply": 4294967296,
    "lastUpdatedDate": "2024-06-18T09:07:49Z",
    "totalUnlockedAmount": 1133988512.7000003,
    "totalLockedAmount": 929041330.499999,
    "totalUntrackedAmount": 0.8000006675720215,
    "totalTBDLockedAmount": 2231937452,
    "allocations": [
      {
        "allocationName": "Core Contributors",
        "allocationType": "Scheduled",
        "standardAllocationName": "Founder / Team",
        "allocationUnlockedAmount": 716795218,
        "allocationLockedAmount": 99248568,
        "allocationAmount": 816043786,
        "trackedAllocationPercentage": 18.999999998835847
      }
    ]
  }
}
Get all token allocations as well as Tokenomist’ own methodology of comparable allocation standards.

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