v1

latestOpenAPI 3.0.32026-07-26282561.6 KB

Upcoming Unlock Events

Upcoming Unlock Events v5

Upcoming unlock events sorted by upcoming time. v5 renames the date params (start/end), adds pagination, and recalculates cliff aggregates after standardAllocation filtering.

get/v5/unlock/events/upcoming

Query parameters

minMarketCapnumber

Filter out tokens below a certain market cap

minReleasedPercentagenumber

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

startstring date

Start date for time filtering (YYYY-MM-DD). Renamed from minUnlockDate in v1.

endstring date

End date for time filtering (YYYY-MM-DD). Renamed from maxUnlockDate in v1.

minTotalUnlockAmountnumber

Filter out unlocks below a certain amount

minValueToMarketCapnumber

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

standardAllocationstring

Comma-separated standard allocations to filter by. Allowed values: community, founderTeam, privateInvestors, publicInvestors, reserve, others. Cliff aggregates are recalculated from the filtered allocations.

pageinteger

Page number (1-indexed).

pageSizeinteger

Number of rows per page.

Response

Successful response

statusboolean

Example response

{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z",
    "credit": {
      "used": 213,
      "limit": 300,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 50,
    "totalPages": 10,
    "total": 487
  },
  "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": {
          "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": "2025-06-13T07:30:52Z"
      }
    }
  ]
}