Skip to main content
GET
/
v2
/
allocations
curl -X 'GET' \
  'https://api.unlocks.app/v2/allocations?tokenId=optimism' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2026-01-08T10:17:39Z"
    },
    "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.

​
Query Parameters

​
tokenId
string
required
Token identifier. Get tokenId from Token List API

​
Response

​
metadata
object
​
status
boolean
Request status
​
data
object
curl -X 'GET' \
  'https://api.unlocks.app/v2/allocations?tokenId=optimism' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2026-01-08T10:17:39Z"
    },
    "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
            }
        ]
    }
}