> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokenomics Summary

> Returns a summary of a coin's supply and unlocks.<br/><br/>Available from&#58; <Badge color="green">Advanced</Badge><br/>Cost&#58; <Badge color="surface">1 credit per request</Badge>

<Note>
  nextUnlockValue = tokens × current price.
</Note>

<Tip>
  Per-group breakdown: [/currencies/:id/vesting/allocations](/api-reference/currencies/vesting-allocations). Emission chart: [/currencies/:id/vesting/chart](/api-reference/currencies/vesting-schedule-chart).
</Tip>


## OpenAPI

````yaml https://api.cryptorank.io/v3/documentation-json get /v3/currencies/{id}/tokenomics
openapi: 3.0.0
info:
  title: Cryptorank API V3
  description: >
    # Overview


    Cryptorank Public API v3 — comprehensive cryptocurrency data for B2B clients
    and partners.


    Useful Links:

    - [API Plans](https://cryptorank.io/public-api)

    - [Dashboard](https://cryptorank.io/public-api/dashboard)


    # Getting Started


    Primary Server URL:
    [https://api.cryptorank.io/v3/](https://api.cryptorank.io/v3/)


    **Authentication**


    Generate an API key in the
    [dashboard](https://cryptorank.io/public-api/dashboard) and pass it in the
    `X-Api-Key` header.


    Keep your keys secret — never commit them to public repositories or expose
    them in client-side code.
  version: 3.0.0
  contact:
    name: Cryptorank Team
    url: https://cryptorank.io
    email: info@cryptorank.io
servers:
  - url: https://api.cryptorank.io
security: []
tags: []
paths:
  /v3/currencies/{id}/tokenomics:
    get:
      tags:
        - Currencies
      summary: Tokenomics Summary
      description: >-
        **Description**


        Returns a summary of a coin's supply and unlocks.


        > **Note:** nextUnlockValue = tokens × current price.


        > **Tip:** Per-group breakdown:
        [/currencies/:id/vesting/allocations](/api-reference/currencies/vesting-allocations).
        Emission chart:
        [/currencies/:id/vesting/chart](/api-reference/currencies/vesting-schedule-chart).


        **Access**

        - Available from: **Advanced**

        - Cost: 1 credit per request
      operationId: CurrenciesController_getTokenomics
      parameters:
        - name: id
          required: true
          in: path
          description: Numeric coin id.
          schema:
            example: 1
            type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - status
                properties:
                  data:
                    $ref: '#/components/schemas/CurrencyTokenomicsDto'
                  status:
                    $ref: '#/components/schemas/ResponseStatusDto'
        '400':
          description: Request validation failed
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - VALIDATION_ERROR
                        example: VALIDATION_ERROR
                      message:
                        type: string
                        example: Validation failed
                      status:
                        type: number
                        example: 400
        '401':
          description: API key is missing or invalid
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - API_KEY_MISSING
                          - API_KEY_INVALID
                        example: API_KEY_MISSING
                      message:
                        type: string
                        example: API key is missing
                      status:
                        type: number
                        example: 401
        '403':
          description: >-
            No active subscription, the endpoint is not available in your plan,
            or the request goes beyond what your plan allows
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - NO_ACTIVE_SUBSCRIPTION
                          - ENDPOINT_NOT_AVAILABLE
                          - PLAN_LIMIT_EXCEEDED
                        example: NO_ACTIVE_SUBSCRIPTION
                      message:
                        type: string
                        example: No active subscription found
                      status:
                        type: number
                        example: 403
        '404':
          description: Currency not found
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - NOT_FOUND
                        example: NOT_FOUND
                      message:
                        type: string
                        example: Resource not found
                      status:
                        type: number
                        example: 404
        '429':
          description: Rate limit or credit limit exceeded
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - RATE_LIMIT_EXCEEDED
                          - DAILY_CREDITS_EXCEEDED
                          - MONTHLY_CREDITS_EXCEEDED
                        example: RATE_LIMIT_EXCEEDED
                      message:
                        type: string
                        example: Rate limit exceeded
                      status:
                        type: number
                        example: 429
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - status
                    properties:
                      code:
                        type: string
                        enum:
                          - INTERNAL_ERROR
                        example: INTERNAL_ERROR
                      message:
                        type: string
                        example: Internal server error
                      status:
                        type: number
                        example: 500
      security:
        - X-Api-Key: []
components:
  schemas:
    CurrencyTokenomicsDto:
      type: object
      properties:
        totalSupply:
          type: string
          example: '21000000'
          nullable: true
          description: 'Total supply: issued minus burned, excluding not-yet-emitted tokens.'
        maxSupply:
          type: string
          example: '21000000'
          nullable: true
          description: Max supply ever to exist. Null if uncapped.
        circulatingSupply:
          type: string
          example: '19700000'
          nullable: true
          description: >-
            Circulating supply: tokens currently in circulation. Null when the
            coin is not actively traded.
        circulatingPercent:
          type: number
          example: 93.81
          nullable: true
          description: >-
            Circulating supply as % of total supply. Null when the coin is not
            actively traded.
        fullyDilutedValuation:
          type: string
          example: '1300000000000'
          nullable: true
          description: >-
            Fully diluted valuation (FDV), USD. Null when the coin is not
            actively traded.
        totalUnlockedAmount:
          type: string
          example: '12500000'
          nullable: true
          description: Total unlocked tokens to date.
        totalUnlockedPercent:
          type: number
          example: 59.52
          nullable: true
          description: Unlocked tokens as % of total supply.
        totalLockedAmount:
          type: string
          example: '8500000'
          nullable: true
          description: Total tokens still locked.
        totalLockedPercent:
          type: number
          example: 40.48
          nullable: true
          description: Locked tokens as % of total supply.
        nextUnlockDate:
          type: string
          example: '2026-07-01T00:00:00.000Z'
          nullable: true
          description: Next unlock date, ISO 8601 UTC.
        nextUnlockTokenAmount:
          type: string
          example: '125000'
          nullable: true
          description: Tokens in the next unlock.
        nextUnlockValue:
          type: string
          example: '8125000'
          nullable: true
          description: >-
            Next unlock value (tokens × current price), USD. Null when the coin
            is not actively traded.
        nextUnlockPercentOfMcap:
          type: number
          example: 0.62
          nullable: true
          description: >-
            Next unlock as % of market cap. Null when the coin is not actively
            traded.
        nextUnlockPercentOfSupply:
          type: number
          example: 0.59
          nullable: true
          description: Next unlock as % of total supply.
        vestingSourceUrls:
          example:
            - https://docs.project.io/tokenomics
          description: Vesting source documentation links. Empty when no vesting data.
          type: array
          items:
            type: string
      required:
        - totalSupply
        - maxSupply
        - circulatingSupply
        - circulatingPercent
        - fullyDilutedValuation
        - totalUnlockedAmount
        - totalUnlockedPercent
        - totalLockedAmount
        - totalLockedPercent
        - nextUnlockDate
        - nextUnlockTokenAmount
        - nextUnlockValue
        - nextUnlockPercentOfMcap
        - nextUnlockPercentOfSupply
        - vestingSourceUrls
    ResponseStatusDto:
      type: object
      properties:
        usedCredits:
          type: number
          example: 1
          description: Credits charged for this request
        timestamp:
          type: number
          example: 1780000000000
          description: Server time of the response. Unix timestamp in milliseconds
      required:
        - usedCredits
        - timestamp
  securitySchemes:
    X-Api-Key:
      name: X-Api-Key
      type: apiKey
      in: header

````