> ## 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.

# Daily emission as of a date

> The daily emission series as it was known at a past date, including the forecast at that time

Same shape as [Daily Emission v5](https://docs.tokenomist.ai/api-documents/daily-emission/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). Cliffs and linear streams follow the same versions.

Differences from v5:

* `metadata.asOf` and `metadata.version` report which version answered.
* The series can run past `asOf`. Days that start after `asOf` were the forecast at `asOf`. Compare `startDate` with `metadata.asOf` to tell them apart.
* `committedClaim` includes only claims with a timestamp on or before `asOf`, and has no USD `value`.
* USD fields (`unlockValue`, `referencePrice`) are not returned.

`start`, `end`, `standardAllocation`, `page` and `pageSize` work as in v5: the series ends with the day before `end`, and a page holds 20 days by default. The plan window for `start` and `end` is counted from today, not from `asOf`.

```bash theme={null}
curl --fail-with-body -s \
  "https://api.tokenomist.ai/v5/point-in-time/daily-emission/worldcoin-wld?asOf=2025-01-01&start=2024-12-31&end=2025-01-26" \
  -H "x-api-key: YOUR_API_KEY"
```

The response below shows the first day of the page:

```json theme={null}
{
  "metadata": {
    "queryDate": "2026-10-29T08:45:03Z",
    "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"
    },
    "page": 1,
    "totalPages": 2,
    "pageSize": 20,
    "total": 26
  },
  "status": true,
  "data": [
    {
      "startDate": "2024-12-31T00:00:00Z",
      "endDate": "2025-01-01T00:00:00Z",
      "tokenName": "Worldcoin",
      "tokenSymbol": "WLD",
      "listedMethod": "INTERNAL",
      "unlockAmount": 5318014.920044347,
      "allocations": [
        { "allocationName": "Worldcoin Community", "standardAllocationName": "Community", "unlockAmount": 3196347.0319634704, "committedClaim": null },
        { "allocationName": "TFH Investors", "standardAllocationName": "Private Investors", "unlockAmount": 1133120.6193509593, "committedClaim": null },
        { "allocationName": "Initial Development Team", "standardAllocationName": "Founder / Team", "unlockAmount": 823938.2152319747, "committedClaim": null },
        { "allocationName": "TFH Reserve", "standardAllocationName": "Reserve", "unlockAmount": 164609.05349794237, "committedClaim": null }
      ],
      "totalCumulativeUnlockedAmount": 2526063415.8258033,
      "committedClaim": null
    }
  ]
}
```


## OpenAPI

````yaml GET /v5/point-in-time/daily-emission/{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/daily-emission/{tokenId}:
    get:
      tags:
        - Point-in-Time History
      summary: Daily emission as of a date
      description: >-
        The daily emission series (cliffs and linear releases) as it was known
        at `asOf`. Days that start after `asOf` are the forecast at that time.
      operationId: getPointInTimeDailyEmissionV5
      parameters:
        - $ref: '#/components/parameters/HistoryTokenId'
        - $ref: '#/components/parameters/HistoryAsOf'
        - $ref: '#/components/parameters/HistoryVersionId'
        - name: start
          in: query
          required: false
          description: >-
            Start date (YYYY-MM-DD), as in v5. Must be inside your plan's
            window, which is counted from today, not from `asOf`.
          schema:
            type: string
            format: date
        - name: end
          in: query
          required: false
          description: >-
            End date (YYYY-MM-DD), as in v5: the series ends with the day before
            it. Can be later than `asOf`.
          schema:
            type: string
            format: date
        - $ref: '#/components/parameters/HistoryStandardAllocation'
        - $ref: '#/components/parameters/HistoryPage'
        - $ref: '#/components/parameters/HistoryPageSize'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/HistoryPaginatedMetadata'
                  status:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/HistoryEmissionDay'
        '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
    HistoryStandardAllocation:
      name: standardAllocation
      in: query
      required: false
      description: >-
        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.
      schema:
        type: string
      example: community,founderTeam
    HistoryPage:
      name: page
      in: query
      required: false
      description: Page number (1-indexed). 0 or omitted means 1.
      schema:
        type: integer
        minimum: 0
    HistoryPageSize:
      name: pageSize
      in: query
      required: false
      description: Number of items per page. 0 or omitted means 20.
      schema:
        type: integer
        minimum: 0
  schemas:
    HistoryPaginatedMetadata:
      allOf:
        - $ref: '#/components/schemas/HistoryMetadata'
        - type: object
          properties:
            page:
              type: integer
              description: Current page number (1-indexed)
              example: 1
            pageSize:
              type: integer
              description: Number of items per page
              example: 20
            totalPages:
              type: integer
              description: Total number of pages available for the current query
              example: 2
            total:
              type: integer
              description: Total number of items across all pages
              example: 27
    HistoryEmissionDay:
      type: object
      properties:
        startDate:
          type: string
          description: 00:00:00Z of the row's UTC day.
          format: date-time
          example: '2024-12-31T00:00:00Z'
        endDate:
          type: string
          description: 00:00:00Z of the next day (exclusive).
          format: date-time
          example: '2025-01-01T00:00:00Z'
        tokenName:
          type: string
          description: Token name
          example: Worldcoin
        tokenSymbol:
          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
        unlockAmount:
          type: number
          description: Total unlock amount for the day, denominated in token
          example: 5318014.920044347
        allocations:
          type: array
          description: >-
            Allocations unlocking that day in the selected version, by
            unlockAmount descending, then allocationName. Empty on a day without
            unlocks.
          items:
            $ref: '#/components/schemas/HistoryEmissionAllocation'
        totalCumulativeUnlockedAmount:
          type: number
          description: Running cumulative unlocked amount
          example: 2526063415.8258033
        committedClaim:
          $ref: '#/components/schemas/HistoryClaim'
    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'
    HistoryEmissionAllocation:
      type: object
      properties:
        allocationName:
          type: string
          description: Allocation name
          example: Worldcoin Community
        standardAllocationName:
          type: string
          description: >-
            One of Founder / Team, Private Investors, Public Investors,
            Community, Others or Reserve (filter keys founderTeam,
            privateInvestors, publicInvestors, community, others, reserve).
          nullable: true
          example: Community
        unlockAmount:
          type: number
          description: Unlock amount denominated in token
          example: 3196347.0319634704
        committedClaim:
          $ref: '#/components/schemas/HistoryClaim'
    HistoryClaim:
      type: object
      nullable: true
      description: >-
        Committed claim as of asOf, without its USD value. Null when there is no
        claim, it has no timestamp, or it was made after asOf. A day's claim
        sums only its allocations' claims made by asOf.
      properties:
        amount:
          type: number
          nullable: true
          description: Committed claim amount denominated in token
          example: 1234567.89
        timestamp:
          type: integer
          nullable: true
          description: >-
            Unix time in seconds of the claim (the latest when several are
            merged).
          example: 1735689600
    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'
    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'
    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.