Skip to main content
GET
/
v2
/
emission
curl -X 'GET' \
  'https://api.unlocks.app/v2/emission?tokenId=arbitrum&start=2026-10-11&end=2026-10-18' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2024-08-20T08:18:14Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2026-10-11T00:00:00Z",
            "endDate": "2026-10-18T00:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "unlockAmount": 95997304.55646817,
            "unlockValue": 52539420.78105959,
            "referencePrice": 0.547301,
            "allocations": [
                {
                    "allocationName": "Team, Future Team + Advisors",
                    "standardAllocationName": "Founder / Team",
                    "unlockAmount": 56125000,
                    "unlockValue": 30717268.625000004
                }
            ],
            "totalCumulativeUnlockedAmount": 6046002268.244544
        }
    ]
}
A weekly aggregated emission per token. The start date is expected to be a Sunday and end date a Saturday. This will include both linear and cliff unlocks that happened in the specified week. Included is the breakdown of beneficiaries into standard allocation, a Tokenomist methodology for categorizing and grouping allocations from different projects into a comparable standard. v2 update: Provides more detailed breakdown of unlock amount and unlock value within the ‘allocations’ field.

​
Query Parameters

​
tokenId
string
required
Token identifier. Get tokenId from Token List API
​
start
string
The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.
​
end
string
The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

​
Response

​
metadata
object
​
status
boolean
Request status
​
data
object[]
curl -X 'GET' \
  'https://api.unlocks.app/v2/emission?tokenId=arbitrum&start=2026-10-11&end=2026-10-18' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2024-08-20T08:18:14Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2026-10-11T00:00:00Z",
            "endDate": "2026-10-18T00:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "unlockAmount": 95997304.55646817,
            "unlockValue": 52539420.78105959,
            "referencePrice": 0.547301,
            "allocations": [
                {
                    "allocationName": "Team, Future Team + Advisors",
                    "standardAllocationName": "Founder / Team",
                    "unlockAmount": 56125000,
                    "unlockValue": 30717268.625000004
                }
            ],
            "totalCumulativeUnlockedAmount": 6046002268.244544
        }
    ]
}