> ## 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 API v2

> Provides more tokens with AI assisted listing and dynamic inflation rate

<Warning>
  This documents the **v2** endpoint, kept for existing integrations. The current version is [allocations v5](/api-documents/allocations/v5). New integrations should use v5.
</Warning>

v2 update: Add Dynamic inflation rate. *value might differ to v1*

v2 update: Provides more tokens that are listed with AI method. Add more field about listing method, see below for field description

| Listing Method | Definition                                                                                                                |
| -------------- | ------------------------------------------------------------------------------------------------------------------------- |
| INTERNAL       | This token is listed and verified and cross checked across multiple sources by tokenomist                                 |
| AI             | This token has been listed using LLM assisted with single source.                                                         |
| EXTERNAL       | This token is listed directly by the project team. It is first-party data and comes solely from the project's own source. |


## OpenAPI

````yaml GET /v2/allocations
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:
  /v2/allocations:
    get:
      tags:
        - Allocations
      summary: Allocations v2
      description: >-
        Get all token allocations with AI assisted listings and dynamic
        inflation rate.
      operationId: getAllocationsV2
      parameters:
        - name: tokenId
          in: query
          required: true
          description: Token identifier. Get from Token List API.
          schema:
            type: string
          example: optimism
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/Metadata'
                  status:
                    type: boolean
                  data:
                    type: object
                    properties:
                      name:
                        type: string
                        example: Optimism
                      symbol:
                        type: string
                        example: OP
                      listedMethod:
                        type: string
                        enum:
                          - INTERNAL
                          - AI
                          - EXTERNAL
                        example: INTERNAL
                      maxSupply:
                        type: number
                        nullable: true
                        example: 4294967296
                      lastUpdatedDate:
                        type: string
                        format: date-time
                        example: '2025-06-11T10:36:43Z'
                      totalUnlockedAmount:
                        type: number
                        example: 1930591949.2000003
                      totalLockedAmount:
                        type: number
                        example: 274658779
                      totalUntrackedAmount:
                        type: number
                        example: 0.8000006675720215
                      totalTBDLockedAmount:
                        type: number
                        example: 2089716567
                      allocations:
                        type: array
                        items:
                          $ref: '#/components/schemas/Allocation'
components:
  schemas:
    Metadata:
      type: object
      properties:
        queryDate:
          type: string
          format: date-time
          description: Timestamp of the query
          example: '2026-01-08T10:13:58Z'
        credit:
          $ref: '#/components/schemas/Credit'
    Allocation:
      type: object
      properties:
        allocationName:
          type: string
          description: Allocation name
          example: Core Contributors
        allocationType:
          type: string
          enum:
            - Scheduled
            - TBD
            - Untracked
          description: Type of allocation
          example: Scheduled
        standardAllocationName:
          type: string
          description: Standard allocation of this allocation
          example: Founder / Team
        allocationUnlockedAmount:
          type: number
          description: Current unlocked amount of the allocation
          example: 716795218
        allocationLockedAmount:
          type: number
          description: Current locked amount of the allocation
          example: 99248568
        allocationAmount:
          type: number
          description: Total token amount assign to this allocation
          example: 816043786
        trackedAllocationPercentage:
          type: number
          description: Total track allocation percentage not include untrack
          example: 18.999999998835847
    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: >-
            Requests counted in the current window (approximate / eventually
            consistent).
          example: 213
        limit:
          type: integer
          description: The plan's request quota for the window.
          example: 300
        resetAt:
          type: string
          format: date-time
          description: >-
            When the quota resets (RFC3339 UTC). Present for monthly plans;
            absent for lifetime-quota plans.
          example: '2026-08-01T00:00:00Z'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Tokenomist API key

````