Skip to main content
GET
/
v1
/
emission
curl -X 'GET' \
  'https://api.unlocks.app/v1/emission?tokenId=optimism&start=2023-06-25&end=2023-07-23' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2024-06-24T13:31:20Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2023-06-25T00:00:00Z",
            "endDate": "2023-07-02T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 31341653,
            "unlockValue": 40744148.9,
            "referencePrice": 1.3,
            "allocations": [
                "Core Contributors",
                "Investors"
            ],
            "standardAllocations": [
                "Founder / Team",
                "Private Investors"
            ]
        }
    ]
}
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.

​
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/v1/emission?tokenId=optimism&start=2023-06-25&end=2023-07-23' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2024-06-24T13:31:20Z"
    },
    "status": true,
    "data": [
        {
            "startDate": "2023-06-25T00:00:00Z",
            "endDate": "2023-07-02T00:00:00Z",
            "tokenName": "Optimism",
            "tokenSymbol": "OP",
            "unlockAmount": 31341653,
            "unlockValue": 40744148.9,
            "referencePrice": 1.3,
            "allocations": [
                "Core Contributors",
                "Investors"
            ],
            "standardAllocations": [
                "Founder / Team",
                "Private Investors"
            ]
        }
    ]
}