v1

latestOpenAPI 3.0.32026-07-26282561.6 KB

Unlock Events

Unlock Events v4

Cliff unlocks only - removes start of Linear unlocks and mining rewards events.

get/v4/unlock/events

Query parameters

tokenIdstring required

Token identifier. Get from Token List API.

startstring date

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

endstring date

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

Response

Successful response

statusboolean

Example response

{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z",
    "credit": {
      "used": 213,
      "limit": 300,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "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"
          }
        ]
      },
      "latestUpdateDate": "2024-06-11T08:49:27Z"
    }
  ]
}