TOtokenomist
Point-in-Time History

Token versions

Changed on

Every project version of a token's unlock schedule: when each was in force, what changed, and the sources behind it, sorted by historyOrder ascending. Corrections are folded into the project version they follow.

get/v5/point-in-time/token-versions/{tokenId}

Request

  • Base URL
    https://api.tokenomist.ai
  • URL
    https://api.tokenomist.ai/v5/point-in-time/token-versions/{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

startstring date

Return versions whose validFrom falls on or after this UTC day (YYYY-MM-DD).

endstring date

Return versions whose validFrom falls on or before this UTC day (YYYY-MM-DD).

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-01-08T10:13:58Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 50,
    "totalPages": 10,
    "total": 487
  },
  "data": [
    {
      "id": "eigenlayer-p-664afd685bc38ff465ce3bf7",
      "tokenId": "eigenlayer",
      "historyOrder": 1,
      "status": "previous",
      "validFrom": "2024-04-29T17:24:21Z",
      "validFromBasis": "stated_in_document",
      "validUntil": "2024-09-04T16:55:06Z",
      "disclosedAt": "2024-04-29T17:24:21Z",
      "change": {
        "category": "project_decision",
        "title": "Updated TBD Allocation Stakedrops with Stakedrop Season 2 release log",
        "description": "Added 1 release. (Stakedrops)",
        "basis": "project_disclosure"
      },
      "changeReferences": [
        {
          "name": "Introducing EIGEN token",
          "url": "https://blog.eigenfoundation.org/announcement/",
          "sourceType": "official_blog",
          "sourceDate": "2024-04-29T17:24:21Z",
          "private": true
        }
      ],
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper"
    }
  ]
}

Changes