> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenomist.ai/llms.txt > Use this file to discover all available pages before exploring further. # Allocations as of a date > The allocation table as it was known at a past date, with amounts evaluated at that date Same shape as [Allocations v5](https://docs.tokenomist.ai/api-documents/allocations/v5.md), answered by the version you select with `asOf` or `versionId`. See [version selector](https://docs.tokenomist.ai/api-documents/point-in-time/overview.md#choose-a-version). Differences from v5: * `metadata.asOf` and `metadata.version` report which version answered. * Each allocation's unlocked and locked amounts, and `totalUnlockedAmount`, are evaluated at the UTC day of `asOf`, not today. A release dated later on that day already counts as unlocked. * `totalLockedAmount` is the sum of the scheduled allocations' locked amounts at `asOf`, as in v5 but evaluated at `asOf`. `totalUntrackedAmount` and `totalTBDLockedAmount` are as in v5. * `maxSupply` is the token's max supply today, as in v5. It is not versioned yet, so a past `asOf` still gets today's value. * `lastUpdatedDate` is removed. Use `metadata.version` instead. ```bash theme={null} curl --fail-with-body -s \ "https://api.tokenomist.ai/v5/point-in-time/allocations/worldcoin-wld?asOf=2025-01-01" \ -H "x-api-key: YOUR_API_KEY" ``` ```json theme={null} { "metadata": { "queryDate": "2026-10-29T08:45:01Z", "asOf": "2025-01-01T00:00:00Z", "version": { "id": "worldcoin-wld-p-669743899f5cd7bb92d56ce0", "historyOrder": 2, "validFrom": "2024-07-16T09:39:33Z", "validFromBasis": "stated_in_document", "validUntil": null, "previousVersionId": "worldcoin-wld-p-64db51750bc04edb16179abf", "status": "current" } }, "status": true, "data": { "name": "Worldcoin", "symbol": "WLD", "listedMethod": "INTERNAL", "maxSupply": 10000000000, "totalUnlockedAmount": 2526063415.825807, "totalLockedAmount": 7473936584.174193, "totalUntrackedAmount": 0, "totalTBDLockedAmount": 0, "allocations": [ { "allocationName": "Worldcoin Community", "allocationType": "Scheduled", "standardAllocationName": "Community", "allocationUnlockedAmount": 2184474885.844786, "allocationLockedAmount": 5315525114.155214, "allocationAmount": 7500000000, "trackedAllocationPercentage": 75 } ] } } ``` ## OpenAPI ````yaml GET /v5/point-in-time/allocations/{tokenId} openapi: 3.0.3 info: title: Tokenomist API description: >- Comprehensive time series data for crypto token unlocks, emissions, allocations, fundraising, burns, and buybacks. version: 1.0.0 servers: - url: https://api.tokenomist.ai security: - apiKey: [] paths: /v5/point-in-time/allocations/{tokenId}: get: tags: - Point-in-Time History summary: Allocations as of a date description: >- 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. operationId: getPointInTimeAllocationsV5 parameters: - $ref: '#/components/parameters/HistoryTokenId' - $ref: '#/components/parameters/HistoryAsOf' - $ref: '#/components/parameters/HistoryVersionId' responses: '200': description: Successful response content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/HistoryMetadata' status: type: boolean data: type: object properties: name: type: string description: Token name example: Worldcoin symbol: type: string description: Token symbol example: WLD listedMethod: type: string description: >- How the data was listed: INTERNAL (Tokenomist research from official sources or on-chain data), AI (AI-listed) or EXTERNAL (submitted by the project). Left out when unknown. enum: - INTERNAL - AI - EXTERNAL example: INTERNAL maxSupply: type: number nullable: true description: >- The token's max supply today, as in v5. Not versioned yet, so a past `asOf` gets today's value. example: 10000000000 totalUnlockedAmount: type: number description: >- Linear releases up to 00:00 UTC on asOf's day plus all cliffs dated that day; asOf's time of day is ignored. example: 2526063415.825807 totalLockedAmount: type: number description: >- Sum of the scheduled allocations' locked amounts at `asOf` example: 7473936584.174193 totalUntrackedAmount: type: number description: >- Today's figure for the selected version, not evaluated at asOf (like maxSupply). example: 0 totalTBDLockedAmount: type: number description: >- Today's figure for the selected version, not evaluated at asOf (like maxSupply). example: 0 allocations: type: array description: >- Each allocation's unlocked and locked amounts are evaluated at the UTC day of `asOf` items: $ref: '#/components/schemas/Allocation' '400': $ref: '#/components/responses/HistoryError' '403': $ref: '#/components/responses/HistoryError' '404': $ref: '#/components/responses/HistoryError' '422': $ref: '#/components/responses/HistoryError' '429': $ref: '#/components/responses/HistoryError' '503': $ref: '#/components/responses/HistoryError' components: parameters: HistoryTokenId: name: tokenId in: path required: true description: >- Token identifier (slug), as in Token List v5. A token not in that list answers 404 `TOKEN_NOT_FOUND`. schema: type: string example: eigenlayer HistoryAsOf: name: asOf in: query required: false description: >- 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. schema: type: string example: '2025-01-01' HistoryVersionId: name: versionId in: query required: false description: >- 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`). schema: type: string schemas: HistoryMetadata: type: object properties: queryDate: type: string format: date-time description: Timestamp of the query example: '2026-10-29T06:24:37Z' asOf: type: string format: date-time description: The instant the response is evaluated at example: '2025-01-01T00:00:00Z' version: $ref: '#/components/schemas/HistoryAppliedVersion' credit: $ref: '#/components/schemas/Credit' Allocation: type: object properties: allocationName: type: string description: Allocation name example: Core Contributors allocationType: type: string enum: - Scheduled - TBD description: >- Scheduled (a release schedule) or TBD (no schedule yet). An allocation with both parts has one row of each, with the same allocationName. example: Scheduled standardAllocationName: type: string description: >- One of Founder / Team, Private Investors, Public Investors, Community, Others or Reserve (filter keys founderTeam, privateInvestors, publicInvestors, community, others, reserve). example: Founder / Team allocationUnlockedAmount: type: number description: >- Unlocked tokens: linear releases up to 00:00 UTC today plus the cliffs dated today (point-in-time: asOf's UTC day). Always 0 on TBD rows. Can exceed allocationAmount when released TBD supply of the same name is counted here. example: 716795218 allocationLockedAmount: type: number description: >- Current locked amount of the allocation, `allocationAmount` minus `allocationUnlockedAmount`, never below 0 example: 99248568 allocationAmount: type: number description: >- Tokens in this row: the scheduled part (Scheduled) or the unscheduled part (TBD). example: 816043786 trackedAllocationPercentage: type: number nullable: true description: >- This row's share of the token's tracked supply, in percent (0-100): allocationAmount ÷ the sum of all rows' allocationAmount × 100. Null when 0. example: 18.999999998835847 HistoryAppliedVersion: type: object description: The project version that answered the request properties: id: type: string description: >- Permanent version id: `{tokenId}-p-{id}`. The prefix is Tokenomist's own token id, usually the path `tokenId` (not for every token, for example `galxe` versions start with `project-galaxy`). Store it as returned. example: eigenlayer-p-6703562619635290c11ad65a historyOrder: type: integer description: >- Position on the project timeline (1 = oldest). It can shift when an earlier version is added later, so use `id` as the key. example: 4 validFrom: type: string format: date-time description: >- When the version came into force: its announcement date, else its first publish on Tokenomist example: '2024-10-04T04:52:36Z' validFromBasis: $ref: '#/components/schemas/HistoryValidFromBasis' validUntil: type: string format: date-time nullable: true description: >- The next project version's start. Null for the latest version. It can be before `validFrom` when the next version's announcement is dated earlier. example: null previousVersionId: type: string nullable: true description: The previous project version. Null for the first. example: eigenlayer-p-66fa656ce4a4901842303dd6 status: type: string description: >- Relative to now, not asOf: current for the latest project version of a token that is live today, else previous. An asOf that selects a since-replaced version gets previous. enum: - current - previous example: current Credit: type: object description: >- Optional quota state for the calling account, returned on most authenticated responses (both success and error). Treat it as optional: it may be absent on unauthenticated requests, demo/playground responses, and briefly right after a monthly reset. `used` is near-real-time and may lag the true count by a request or two. properties: used: type: integer description: >- Successful requests (status below 400) made by your account, across all its keys, since the start of the month; errors use no credit. May lag by a request or two. example: 213 limit: type: integer description: The plan's request quota for the window. example: 1000 resetAt: type: string format: date-time description: 'When the quota resets: the 1st of next month, 00:00 UTC (RFC 3339).' example: '2026-08-01T00:00:00Z' HistoryError: type: object properties: metadata: type: object properties: queryDate: type: string format: date-time example: '2026-10-29T06:25:07Z' credit: $ref: '#/components/schemas/Credit' status: type: boolean example: false statusCode: type: integer example: 404 errorCode: type: string enum: - INVALID_AS_OF - INVALID_PARAMETER - PLAN_NOT_ELIGIBLE - TOKEN_NOT_FOUND - NO_VERSION_AT_AS_OF - VERSION_NOT_FOUND - NOT_FOUND - SERVICE_UNAVAILABLE - INTERNAL_ERROR example: TOKEN_NOT_FOUND errorMessage: type: string example: Token not found earliestValidDate: type: string format: date-time description: >- With `NO_VERSION_AT_AS_OF`, or `PLAN_NOT_ELIGIBLE` for an `asOf` or `versionId` outside your plan's range: the first instant that selects a version. Send it back as `asOf`. Absent when no later version exists. example: '2023-10-29T00:00:00Z' HistoryValidFromBasis: type: string description: >- How a project version's start date was established. `stated_in_document`: the vote or announcement states the time. `onchain`: a governance proposal's voting end on chain. `url`: the time encoded in the announcement's link. `archive_first_seen`: the first web archive capture (an upper bound). `first_published`: no dated announcement, so the start is the first publish on Tokenomist (public no later than then). enum: - stated_in_document - onchain - url - archive_first_seen - first_published example: stated_in_document responses: HistoryError: description: >- Error. `400 INVALID_AS_OF`: `asOf` is invalid or in the future. `400 INVALID_PARAMETER`: another parameter is invalid. `403 PLAN_NOT_ELIGIBLE`: your plan does not include the version selector on this endpoint, or `asOf` / `versionId` is outside your plan's range (a 403 without `errorCode` means your plan does not include the endpoint). `404 TOKEN_NOT_FOUND`, `404 NO_VERSION_AT_AS_OF` (no project version in force at `asOf`), `404 VERSION_NOT_FOUND` (`versionId` does not belong to this token). `422 INVALID_PARAMETER`: `asOf` and `versionId` together, or `start` / `end` outside your plan's window. `429` (no `errorCode`): rate limit or monthly credit quota, as in v5. `503 SERVICE_UNAVAILABLE`: retry shortly. Errors use no credit. content: application/json: schema: $ref: '#/components/schemas/HistoryError' securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: Your Tokenomist API key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.