Emission API v2

Overview

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.

See below for each field description.

Getting Started

Base URL

https://api.unlocks.app

Authentication

Provide your api key in the x-api-key header.

GET https://api.unlocks.app/v2/emission
HEADER: x-api-key: <YOUR_API_KEY>

Endpoints: Emission API v2

Parameters

Note: tokenID needs to be specified.

• tokenId (required): Get tokenId from Token List API
• start (optional): The start date for time filtering in the format YYYY-MM-DD. Defaults to the earliest available date.

• end (optional): The end date for time filtering in the format YYYY-MM-DD. Defaults to the current date.

Get Specific Date Range Example:

Replace the preferred start and end dates in indicated format.

Including breakdown of : allocationName, standardAllocationName, unlockAmount, unlockValue, and totalCumulativeUnlockedAmount. See below for each field definitions.

curl -X 'GET' \
  'https://api.unlocks.app/v2/emission?tokenId=arbitrum&start=YYYY-MM-DD&end=YYYY-MM-DD' \
  -H 'x-api-key: $YOUR_API_KEY'

Get Full Data Range Example:

Remove date completely to call the full range.

curl -X 'GET' \
  'https://api.unlocks.app/v2/emission?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'

Response

{
    "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
                  },
                  {
                    "allocationName": "Investors",
                    "standardAllocationName": "Private Investors",
                    "unlockAmount": 36520833,
                    "unlockValue": 19987888.421733003
                  },
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6046002268.244544
              },
              {
                "startDate": "2026-10-18T00:00:00Z",
                "endDate": "2026-10-25T00:00:00Z",
                "tokenName": "Arbitrum",
                "tokenSymbol": "ARB",
                "unlockAmount": 3351471.556468172,
                "unlockValue": 1834263.734326587,
                "referencePrice": 0.547301,
                "allocations": [
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6049353739.801012
              },
              {
                "startDate": "2026-10-25T00:00:00Z",
                "endDate": "2026-11-01T00:00:00Z",
                "tokenName": "Arbitrum",
                "tokenSymbol": "ARB",
                "unlockAmount": 3351471.556468172,
                "unlockValue": 1834263.734326587,
                "referencePrice": 0.547301,
                "allocations": [
                  {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 3351471.556468172,
                    "unlockValue": 1834263.734326587
                  }
                ],
                "totalCumulativeUnlockedAmount": 6052705211.35748
              },
        ...
    ]
}

The response includes time series data with the date (in UTC timezone), with granularity at the level of week.

Return Fields Explanation

Fields	Data Type	Description
startDate	timestamp	Start date of the aggregated emission
endDate	timestamp	End date of the aggregated emission
tokenName	string	Token name
tokenSymbol	string	Token symbol
unlockAmount	number	Total Unlock amount in date period
unlockValue	number	Total unlock value in date period
referencePrice	number	Reference price for unlockValue calculation
allocations	object array	Expand allocation details
allocationName	string	Allocation name
standardAllocationName	string	Standard allocation of this allocation
totalCumulativeUnlockedAmount	number	Total unlocked amount from token TGE till specified endDate