Skip to main content
GET
/
v5
/
unlock
/
events
/
{tokenId}
Unlock Events v5
curl --request GET \
  --url https://api.tokenomist.ai/v5/unlock/events/{tokenId} \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z",
    "page": 1,
    "pageSize": 50,
    "totalPages": 10,
    "total": 487
  },
  "status": true,
  "data": [
    {
      "unlockDate": "2024-09-16T13:00:00Z",
      "tokenName": "Arbitrum",
      "tokenSymbol": "ARB",
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "cliffUnlocks": {
        "cliffAmount": 92645833.29999995,
        "cliffValue": 49929711.58620228,
        "valueToMarketCap": 2.7744266354166256,
        "allocationBreakdown": [
          {
            "unlockDate": "2024-09-16T13:00:00Z",
            "allocationName": "Investors",
            "standardAllocationName": "Private Investors",
            "cliffAmount": 36520833.29999995,
            "cliffValue": 19682209.211202275,
            "referencePrice": 0.538931,
            "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
            "unlockPrecision": "month",
            "committedClaim": {
              "amount": 1234567.89,
              "value": 987654.32,
              "timestamp": 1735689600
            }
          }
        ]
      },
      "latestUpdateDate": "2024-06-11T08:49:27Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.tokenomist.ai/llms.txt

Use this file to discover all available pages before exploring further.

v5 update: Token identifier moves to a path param. Adds pagination (page, pageSize), optional standardAllocation filter, and committedClaim data per allocation.

Authorizations

​
x-api-key
string
header
required

Your Tokenomist API key

Path Parameters

​
tokenId
string
required

Token identifier (slug). Get from Token List API.

Query Parameters

​
start
string<date>

Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.

​
end
string<date>

End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.

​
standardAllocation
string

Comma-separated list of standard allocations to filter by. Allowed values: community, founderTeam, privateInvestors, publicInvestors, others, reserve. Aggregates (cliffAmount, cliffValue) are recalculated from the filtered allocations; events with no matching allocations are excluded.

​
page
integer

Page number (1-indexed).

Required range: x >= 1
​
pageSize
integer

Number of rows per page.

Required range: x >= 1

Response

200 - application/json

Successful response

​
metadata
object
​
status
boolean
​
data
object[]