Skip to main content
GET
/
v1
/
unlock
/
events
/
upcoming
Upcoming Unlock Events
curl --request GET \
  --url https://api.tokenomist.ai/v1/unlock/events/upcoming \
  --header 'x-api-key: <api-key>'
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": [
    {
      "tokenId": "layerzero",
      "tokenName": "LayerZero",
      "tokenSymbol": "ZRO",
      "marketCap": 278811255,
      "releasedPercentage": 35.2833333550565,
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "upcomingEvent": {
        "unlockDate": "2025-11-20T11:00:00Z",
        "referencePrice": 1.4,
        "referencePriceUpdatedTime": "2025-11-20T00:00:00Z",
        "cliffUnlocks": {
          "totalCliffAmount": 25708332.666,
          "totalCliffValue": 35991665.7324,
          "valueToMarketCap": 12.908971602455575,
          "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": "2025-06-13T07:30:52Z"
      }
    }
  ]
}
This endpoint is the timestamp information of the upcoming unlock events. This dataset is the same scheme to Unlock Events API but sort by upcoming time, similar Homepage

Authorizations

​
x-api-key
string
header
required

Your Tokenomist API key

Query Parameters

​
minMarketCap
number

Filter out tokens below a certain market cap

​
minReleasedPercentage
number

Filter out tokens below a certain percentage of released supply from 0-100

​
minUnlockDate
string<date>

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

​
maxUnlockDate
string<date>

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

​
minTotalUnlockAmount
number

Filter out unlocks below a certain amount

​
minValueToMarketCap
number

Filter out unlocks below a certain value market cap from 0-100

​
standardAllocation
string

Filter the receiver's allocation. Multi-select: community, founderTeam, privateInvestors, publicInvestors, reserve, others

Response

200 - application/json

Successful response

​
metadata
object
​
status
boolean
​
data
object[]