Skip to main content
GET
/
v3
/
unlock
/
events
Unlock Events v3
curl --request GET \
  --url https://api.tokenomist.ai/v3/unlock/events \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": [
    {
      "unlockDate": "2024-09-16T13:00:00Z",
      "tokenName": "Arbitrum",
      "tokenSymbol": "ARB",
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "linearUnlocks": {
        "linearAmount": 5000000,
        "linearValue": 2694655,
        "dailyAmount": 16666.67,
        "dailyValue": 8982.18,
        "referencePrice": 0.538931,
        "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
        "allocationBreakdown": [
          {
            "allocationName": "Investors",
            "standardAllocationName": "Private Investors",
            "linearAmount": 5000000,
            "linearValue": 2694655,
            "referencePrice": 0.538931,
            "referencePriceUpdatedTime": "2024-08-19T07:30:24Z",
            "dailyAmount": 16666.67,
            "dailyValue": 8982.18,
            "durationOfRate": 300,
            "beginDate": "2024-03-16T13:00:00Z",
            "endDate": "2025-01-16T13:00:00Z",
            "unlockPrecision": "second"
          }
        ]
      },
      "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"
          }
        ]
      },
      "latestUpdateDate": "2024-06-11T08:49:27Z"
    }
  ]
}
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.
unlockPrecision for AI listed token might be unknown

Authorizations

x-api-key
string
header
required

Your Tokenomist API key

Query Parameters

tokenId
string
required
start
string<date>
end
string<date>

Response

200 - application/json

Successful response

metadata
object
status
boolean
data
object[]