TOtokenomist
Point-in-Time History

Allocations as of a date

Changed on

The allocation table as it was known at asOf, with unlocked and locked amounts evaluated at asOf. Same shape as Allocations v5 without lastUpdatedDate, plus the applied version.

get/v5/point-in-time/allocations/{tokenId}

Request

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

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"
    }
  },
  "data": {
    "name": "Worldcoin",
    "symbol": "WLD",
    "listedMethod": "INTERNAL",
    "maxSupply": 10000000000,
    "totalUnlockedAmount": 2526063415.825807,
    "totalLockedAmount": 7473936584.174193,
    "allocations": [
      {
        "allocationName": "Core Contributors",
        "allocationType": "Scheduled",
        "standardAllocationName": "Founder / Team",
        "allocationUnlockedAmount": 716795218,
        "allocationLockedAmount": 99248568,
        "allocationAmount": 816043786,
        "trackedAllocationPercentage": 18.999999998835847
      }
    ]
  }
}

Changes