Daily Emission API v2

⬆️ v2 update: Add Dynamic inflation rate. *value might differ to v1* in some tokens

⬆️ v2 update: Provides more tokens that are listed with AI method. Add more field about listing method, see below for field description

Listing Method
Definition

INTERNAL

This token is listed and verified and cross checked across multiple sources by tokenomist

AI

This token has been listed using LLM assisted with single source.

EXTERNAL

This token is listed directly by the project team. It is first-party data and comes solely from the project's own source.

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/daily-emission
HEADER: x-api-key: <YOUR_API_KEY>

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.

curl -X 'GET' \
  'https://api.unlocks.app/v2/daily-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/daily-emission?tokenId=arbitrum' \
  -H 'x-api-key: $YOUR_API_KEY'

Response

        {
            "startDate": "2023-08-28T00:00:00Z",
            "endDate": "2023-08-29T00:00:00Z",
            "tokenName": "Arbitrum",
            "tokenSymbol": "ARB",
            "listedMethod": "INTERNAL",
            "unlockAmount": 478781.65471694345,
            "unlockValue": 459009.88750375254,
            "referencePrice": 0.958704,
            "allocations": [
                {
                    "allocationName": "Arbitrum DAO Treasury",
                    "standardAllocationName": "Reserve",
                    "unlockAmount": 478781.65471694345,
                    "unlockValue": 459009.88750375254
                }
            ],
            "totalCumulativeUnlockedAmount": 1439391663.491036
        },

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

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

listedMethod

string

Method of listing(INTERNAL, AI, EXTERNAL)

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

totalCumulativeUnlockedAmount

number

Total unlocked amount from token TGE till specified endDate

Return Fields Explanation: Allocations

Fields
Data Type
Description

allocationName

string

Allocation name

standardAllocationName

string

Standard allocation of this allocation

unlockedAmount

number

Total Unlock amount in date period

unlockedValue

number

Total unlock value in date period

Last updated