TOtokenomist
Point-in-Time History

Unlock events as of a date

Changed on

Cliff unlock events as they were known at asOf.

get/v5/point-in-time/unlock/events/{tokenId}

Request

  • Base URL
    https://api.tokenomist.ai
  • URL
    https://api.tokenomist.ai/v5/point-in-time/unlock/events/{tokenId}
  • Auth
    API key in header x-api-key

Path parameters

tokenIdstring required

Token identifier (slug), as in Token List v5. A token not in that list answers 404 TOKEN_NOT_FOUND.

Query parameters

asOfstring

Decision time T, as an RFC 3339 datetime or YYYY-MM-DD (00:00:00 UTC that day). Returns the project version in force at T. Defaults to now, which returns the current version. A future date returns 400 INVALID_AS_OF. Cannot be combined with versionId (422 INVALID_PARAMETER). Your plan sets how far back it can go.

versionIdstring

A project version id from the token versions endpoint, for example eigenlayer-p-6703562619635290c11ad65a. Returns that version, evaluated at its start or at the start of your plan's range, whichever is later. Cannot be combined with asOf (422 INVALID_PARAMETER).

startstring date

Start date (YYYY-MM-DD), as in v5. Must be inside your plan's window, which is counted from today, not from asOf.

endstring date

End date (YYYY-MM-DD), as in v5: an unlock at 00:00 UTC that day is included. Can be later than asOf.

standardAllocationstring

Comma-separated list of standard allocations to filter by. Allowed values: community, founderTeam, privateInvestors, publicInvestors, others, reserve. An unknown value or an empty item (for example a trailing comma): 422; an empty parameter is ignored. Aggregates (unlockAmount, totalCumulativeUnlockedAmount, cliffAmount, committedClaim) are recalculated from the kept allocations.

pageinteger

Page number (1-indexed). 0 or omitted means 1.

pageSizeinteger

Number of items per page. 0 or omitted means 20.

Response

Successful response

statusboolean

Example response

{
  "metadata": {
    "queryDate": "2026-10-29T06:24:37Z",
    "asOf": "2025-01-01T00:00:00Z",
    "version": {
      "id": "eigenlayer-p-6703562619635290c11ad65a",
      "historyOrder": 4,
      "validFrom": "2024-10-04T04:52:36Z",
      "validFromBasis": "stated_in_document",
      "previousVersionId": "eigenlayer-p-66fa656ce4a4901842303dd6",
      "status": "current"
    },
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 20,
    "totalPages": 2,
    "total": 27
  },
  "data": [
    {
      "unlockDate": "2024-10-15T19:00:00Z",
      "tokenName": "EigenCloud (prev. EigenLayer)",
      "tokenSymbol": "EIGEN",
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "cliffUnlocks": {
        "cliffAmount": 11218945.71,
        "allocationBreakdown": [
          {
            "unlockDate": "2024-10-15T19:00:00Z",
            "allocationName": "Future community initiatives",
            "standardAllocationName": "Community",
            "cliffAmount": 11218945.71,
            "unlockPrecision": "second",
            "committedClaim": {
              "amount": 1234567.89,
              "timestamp": 1735689600
            }
          }
        ]
      }
    }
  ]
}

Changes