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

{
    "metadata": {
        "queryDate": "2026-01-08T10:20:00Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2026-10-11T00:00:00Z",
            "endDate": "2026-10-18T00:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "listedMethod": "INTERNAL",
            "unlockAmount": 95997304.55646817,
            "unlockValue": 52539420.78105959,
            "referencePrice": 0.547301,
            "allocations": [
                {
                    "allocationName": "Team, Future Team + Advisors",
                    "standardAllocationName": "Founder / Team",
                    "unlockAmount": 56125000,
                    "unlockValue": 30717268.625000004
                },
                {
                    "allocationName": "Investors",
                    "standardAllocationName": "Private Investors",
                    "unlockAmount": 36520833,
                    "unlockValue": 19987888.421733003
                }
            ],
            "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. v3 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
​
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/v3/emission?tokenId=arbitrum&start=2026-10-11&end=2026-10-18' \
  -H 'x-api-key: $YOUR_API_KEY'

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