### GET /v2/allocations

Source: https://docs.tokenomist.ai/api-documents/allocations/v2

Retrieves all token allocations with AI-assisted listings and dynamic inflation rates. Requires an API key for authentication.

```APIDOC
## GET /v2/allocations

### Description
Get all token allocations with AI assisted listings and dynamic inflation rate.

### Method
GET

### Endpoint
https://api.tokenomist.ai/v2/allocations

### Parameters
#### Query Parameters
- **tokenId** (string) - Required - Token identifier. Get from Token List API.

### Request Example
```json
{
  "tokenId": "optimism"
}
```

### Response
#### Success Response (200)
- **metadata** (object) - Metadata about the query, including queryDate.
- **status** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains the allocation data for the specified token.
  - **name** (string) - Name of the token.
  - **symbol** (string) - Symbol of the token.
  - **listedMethod** (string) - Method used for listing the token (INTERNAL, AI, EXTERNAL).
  - **maxSupply** (number) - Maximum supply of the token (nullable).
  - **lastUpdatedDate** (string) - The last updated date for the token data.
  - **totalUnlockedAmount** (number) - Total amount of tokens unlocked.
  - **totalLockedAmount** (number) - Total amount of tokens locked.
  - **totalUntrackedAmount** (number) - Total amount of untracked tokens.
  - **totalTBDLockedAmount** (number) - Total amount of tokens with status To Be Determined (TBD) locked.
  - **allocations** (array) - List of allocation details.
    - **allocationName** (string) - Name of the allocation.
    - **allocationType** (string) - Type of allocation (Scheduled, TBD, Untracked).
    - **standardAllocationName** (string) - Standardized name for the allocation.
    - **allocationUnlockedAmount** (number) - Unlocked amount for this specific allocation.
    - **allocationLockedAmount** (number) - Locked amount for this specific allocation.
    - **allocationAmount** (number) - Total amount assigned to this allocation.
    - **trackedAllocationPercentage** (number) - Percentage of the tracked allocation.

#### Response Example
```json
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "name": "Optimism",
    "symbol": "OP",
    "listedMethod": "INTERNAL",
    "maxSupply": 4294967296,
    "lastUpdatedDate": "2025-06-11T10:36:43Z",
    "totalUnlockedAmount": 1930591949.2000003,
    "totalLockedAmount": 274658779,
    "totalUntrackedAmount": 0.8000006675720215,
    "totalTBDLockedAmount": 2089716567,
    "allocations": [
      {
        "allocationName": "Core Contributors",
        "allocationType": "Scheduled",
        "standardAllocationName": "Founder / Team",
        "allocationUnlockedAmount": 716795218,
        "allocationLockedAmount": 99248568,
        "allocationAmount": 816043786,
        "trackedAllocationPercentage": 18.999999998835847
      }
    ]
  }
}
```
```

--------------------------------

### GET /v2/allocations OpenAPI Specification

Source: https://docs.tokenomist.ai/api-documents/allocations/v2

This OpenAPI 3.0.3 specification defines the GET /v2/allocations endpoint. It includes details on request parameters, response schemas for successful requests, and component schemas for metadata and allocation data. Use this endpoint to retrieve all token allocations with AI-assisted listings and dynamic inflation rates.

```yaml
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'
    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
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Tokenomist API key

```

--------------------------------

### GET /v1/buyback/{tokenId}

Source: https://docs.tokenomist.ai/api-documents/buyback/v1

Retrieves time series data of buyback events for a specific token, including when and how projects repurchase their own tokens from the market.

```APIDOC
## GET /v1/buyback/{tokenId}

### Description
Retrieves time series data of buyback events for a specific token, including when and how projects repurchase their own tokens from the market.

### Method
GET

### Endpoint
/v1/buyback/{tokenId}

### Parameters
#### Path Parameters
- **tokenId** (string) - Required - Token identifier. Get from Token List API.

#### Query Parameters
- **start** (string) - Optional - Start date for time filtering (YYYY-MM-DD).
- **end** (string) - Optional - End date for time filtering (YYYY-MM-DD).

### Response
#### Success Response (200)
- **metadata** (object) - Query metadata including timestamp.
- **status** (boolean) - Request status.
- **data** (object) - Buyback data including token details and list of events.

#### Response Example
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "tokenId": "hyperliquid",
    "tokenName": "Hyperliquid",
    "tokenSymbol": "HYPE",
    "totalBuybackAmount": 318370.2349536178,
    "buybacks": [
      {
        "buybackEventLabel": "Missing HYPE Assistance Fund Buyback",
        "buybackType": "TREASURY_BUYBACK",
        "buybackDate": "2024-11-30T17:00:00Z",
        "tokenAmount": 159185.1174768089,
        "value": 1036295.1147740259,
        "targetAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
        "buyerAddress": "0xfefefefefefefefefefefefefefefefefefefefe",
        "resolution": "period_net",
        "basis": "estimated"
      }
    ]
  }
}
```

--------------------------------

### Token Fundraising API Response Example

Source: https://docs.tokenomist.ai/api-documents/token-fundraising/v1

This is a successful JSON response for the Token Fundraising API. It contains metadata about the query and the fundraising data for the specified token, including funding rounds, amounts raised, and investors.

```json
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "tokenId": "uniswap",
    "tokenName": "Uniswap",
    "tokenSymbol": "UNI",
    "listedMethod": "INTERNAL",
    "totalAmountRaised": 181000000,
    "unlockedInvestor": 123,
    "investorReleasedPercentage": 123,
    "fundingRounds": [
      {
        "fundingRound": "Series B",
        "fundingDate": "2022-10-13T00:00:00Z",
        "raiseType": "<string>",
        "amountRaised": 165000000,
        "valuation": 1660000000,
        "pricePerToken": 123,
        "sourceURLList": [
          "https://blog.uniswap.org/bringing-web3-to-everyone"
        ],
        "investors": [
          {
            "investorId": "polychain-capital",
            "investorName": "Polychain Capital",
            "isLeadInvestor": true
          }
        ],
        "numberOfInvestors": 5
      }
    ]
  }
}
```

--------------------------------

### GET /v1/fundraising/token/{tokenId}

Source: https://docs.tokenomist.ai/api-documents/token-fundraising/v1

Retrieves detailed fundraising information for a specific token, including funding rounds, amounts raised, and investors.

```APIDOC
## GET /v1/fundraising/token/{tokenId}

### Description
Retrieves detailed fundraising information for a specific token, including funding rounds, amounts raised, and investors.

### Method
GET

### Endpoint
/v1/fundraising/token/{tokenId}

### Parameters
#### Path Parameters
- **tokenId** (string) - Required - Token identifier. Get from Token List API.

#### Query Parameters
- **fundingDateMin** (string<date>) - Optional - Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.
- **fundingDateMax** (string<date>) - Optional - End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.
- **raisedAmountMin** (number) - Optional - Minimum amount raised for filtering.
- **raisedAmountMax** (number) - Optional - Maximum amount raised for filtering.

#### Authorizations
- **x-api-key** (string) - Header - Required - Your Tokenomist API key

### Request Example
```json
{
  "example": "request body"
}
```

### Response
#### Success Response (200)
- **metadata** (object) - Show child attributes
- **status** (boolean) -
- **data** (object) - Show child attributes

#### Response Example
```json
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": {
    "tokenId": "uniswap",
    "tokenName": "Uniswap",
    "tokenSymbol": "UNI",
    "listedMethod": "INTERNAL",
    "totalAmountRaised": 181000000,
    "unlockedInvestor": 123,
    "investorReleasedPercentage": 123,
    "fundingRounds": [
      {
        "fundingRound": "Series B",
        "fundingDate": "2022-10-13T00:00:00Z",
        "raiseType": "<string>",
        "amountRaised": 165000000,
        "valuation": 1660000000,
        "pricePerToken": 123,
        "sourceURLList": [
          "https://blog.uniswap.org/bringing-web3-to-everyone"
        ],
        "investors": [
          {
            "investorId": "polychain-capital",
            "investorName": "Polychain Capital",
            "isLeadInvestor": true
          }
        ],
        "numberOfInvestors": 5
      }
    ]
  }
}
```
```

--------------------------------

### OpenAPI Specification for Investor Fundraising

Source: https://docs.tokenomist.ai/api-documents/investors/v1

Defines the GET endpoint for retrieving fundraising data, including optional query filters for lead investor status, date ranges, and funding amounts.

```yaml
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:
  /v1/fundraising/investors/{investorId}:
    get:
      tags:
        - Fundraising
      summary: Investors
      description: >-
        Fundraising data per investor including funding date, round, amount
        raised, valuation and price per token.
      operationId: getInvestorFundraising
      parameters:
        - name: investorId
          in: path
          required: true
          description: Investor identifier. Get from Investor List API.
          schema:
            type: string
          example: andreessen-horowitz
        - name: isLeadInvestor
          in: query
          required: false
          description: Show only rounds that are led by this investor
          schema:
            type: boolean
        - name: fundingDateMin
          in: query
          required: false
          description: >-
            Start date for time filtering (YYYY-MM-DD). Defaults to earliest
            available date.
          schema:
            type: string
            format: date
        - name: fundingDateMax
          in: query
          required: false
          description: >-
            End date for time filtering (YYYY-MM-DD). Defaults to furthest
            available date.
          schema:
            type: string
            format: date
        - name: raisedAmountMin
          in: query
          required: false
          description: Minimum amount raised for filtering
          schema:
            type: number
        - name: raisedAmountMax
          in: query
          required: false
          description: Maximum amount raised for filtering
          schema:
            type: number
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/Metadata'
                  status:
                    type: boolean
                  data:
                    type: object
                    properties:
                      investorId:
                        type: string
                        example: andreessen-horowitz
                      investorName:
                        type: string
                        example: Andreessen Horowitz (a16z)
                      website:
                        type: string
                        example: https://a16z.com/,https://twitter.com/a16zcrypto
                      fundingRounds:
                        type: array
                        items:
                          $ref: '#/components/schemas/InvestorFundingRound'
components:
  schemas:
    Metadata:
      type: object
      properties:
        queryDate:
          type: string
          format: date-time
          description: Timestamp of the query
          example: '2026-01-08T10:13:58Z'
    InvestorFundingRound:
      type: object
      properties:
        tokenId:
          type: string
          description: Token Id
          example: apecoin
        roundName:
          type: string
          description: Round Name
          example: Seed Round
        isLeadInvestor:
          type: boolean
          description: Identifier for Lead Investor
          example: true
        fundingDate:
          type: string
          format: date-time
          example: '2022-03-22T00:00:00Z'
        totalAmountRaisedinThatRound:
          type: number
          description: Total Amount Raised in That Round
          example: 450000000
        valuation:
          type: number
          nullable: true
          description: Valuation for Funding Round
          example: 4000000000
        pricePerToken:
          type: number
          nullable: true
          description: Cost of Token for this Investor at that Round
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Tokenomist API key
```

--------------------------------

### Investor List API v1 OpenAPI Specification

Source: https://docs.tokenomist.ai/api-documents/investor-list/v1

This OpenAPI 3.0.3 specification defines the GET /v1/fundraising/investors/list endpoint. It includes details on the server URL, security requirements, path operations, request parameters, response schemas, and component schemas for metadata and investor information.

```yaml
GET /v1/fundraising/investors/list
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:
  /v1/fundraising/investors/list:
    get:
      tags:
        - Fundraising
      summary: Investor List
      description: Get a list of all investorID to use for calling Investors API.
      operationId: getInvestorList
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/Metadata'
                  status:
                    type: boolean
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        investorId:
                          type: string
                          description: Identifier to call for a Dataset
                          example: 01-advisors
                        investorName:
                          type: string
                          description: Investor Name
                          example: 01 Advisors
                        website:
                          type: string
                          description: Link to Investor Website
                          example: >-
                            https://01a.com/,https://www.linkedin.com/company/01a/,https://x.com/01Advisors
                        latestFundingDate:
                          type: string
                          format: date-time
                          description: Latest Investment Activity From The Investor
                          example: '2021-11-04T00:00:00Z'
components:
  schemas:
    Metadata:
      type: object
      properties:
        queryDate:
          type: string
          format: date-time
          description: Timestamp of the query
          example: '2026-01-08T10:13:58Z'
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Tokenomist API key

```

--------------------------------

### Retrieve Upcoming Unlock Events via OpenAPI

Source: https://docs.tokenomist.ai/api-documents/upcoming-unlock-events/v1

Defines the GET /v1/unlock/events/upcoming endpoint, including query parameters for market cap, supply percentage, and date ranges.

```yaml
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:
  /v1/unlock/events/upcoming:
    get:
      tags:
        - Upcoming Unlock Events
      summary: Upcoming Unlock Events
      description: Upcoming unlock events sorted by upcoming time, similar to Homepage.
      operationId: getUpcomingUnlockEvents
      parameters:
        - name: minMarketCap
          in: query
          required: false
          description: Filter out tokens below a certain market cap
          schema:
            type: number
        - name: minReleasedPercentage
          in: query
          required: false
          description: >-
            Filter out tokens below a certain percentage of released supply from
            0-100
          schema:
            type: number
        - name: minUnlockDate
          in: query
          required: false
          description: >-
            Start date for time filtering (YYYY-MM-DD). Defaults to earliest
            available date.
          schema:
            type: string
            format: date
        - name: maxUnlockDate
          in: query
          required: false
          description: >-
            End date for time filtering (YYYY-MM-DD). Defaults to furthest
            available date.
          schema:
            type: string
            format: date
        - name: minTotalUnlockAmount
          in: query
          required: false
          description: Filter out unlocks below a certain amount
          schema:
            type: number
        - name: minValueToMarketCap
          in: query
          required: false
          description: Filter out unlocks below a certain value market cap from 0-100
          schema:
            type: number
        - name: standardAllocation
          in: query
          required: false
          description: >-
            Filter the receiver's allocation. Multi-select: community,
            founderTeam, privateInvestors, publicInvestors, reserve, others
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    $ref: '#/components/schemas/Metadata'
                  status:
                    type: boolean
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        tokenId:
                          type: string
                          example: layerzero
                        tokenName:
                          type: string
                          example: LayerZero
                        tokenSymbol:
                          type: string
                          example: ZRO
                        marketCap:
                          type: number
                          nullable: true
                          example: 278811255
                        releasedPercentage:
                          type: number
                          example: 35.2833333550565
                        listedMethod:
                          type: string
                          example: INTERNAL
                        dataSource:
                          type: string
                          example: Whitepaper
                        upcomingEvent:
                          type: object
                          properties:
                            unlockDate:
                              type: string
                              format: date-time
                              example: '2025-11-20T11:00:00Z'
                            referencePrice:
                              type: number
                              example: 1.4
                            referencePriceUpdatedTime:
                              type: string
                              format: date-time
                              example: '2025-11-20T00:00:00Z'
                            cliffUnlocks:
                              type: object
                              properties:
                                totalCliffAmount:
                                  type: number
                                  example: 25708332.666
                                totalCliffValue:
                                  type: number
                                  example: 35991665.7324
                                valueToMarketCap:
                                  type: number
                                  example: 12.908971602455575
                                allocationBreakdown:
```

--------------------------------

### GET /v2/daily-emission

Source: https://docs.tokenomist.ai/api-documents/daily-emission/v2

Retrieves daily emission data per token, including AI-assisted listings and dynamic inflation rates. This endpoint provides detailed information about token unlocks and their values over time.

```APIDOC
## GET /v2/daily-emission

### Description
Daily emission data per token with AI assisted listings and dynamic inflation rate.

### Method
GET

### Endpoint
/v2/daily-emission

### Parameters
#### Query Parameters
- **tokenId** (string) - Required - Token identifier. Get from Token List API.
- **start** (string) - Optional - Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.
- **end** (string) - Optional - End date for time filtering (YYYY-MM-DD). Defaults to current date.

### Request Example
```json
{
  "example": "/v2/daily-emission?tokenId=arbitrum&start=2024-01-01&end=2024-01-31"
}
```

### Response
#### Success Response (200)
- **metadata** (object) - Metadata about the query.
- **status** (boolean) - Indicates if the request was successful.
- **data** (array) - Array of daily emission data objects.
  - **startDate** (string) - Start date of the emission period.
  - **endDate** (string) - End date of the emission period.
  - **tokenName** (string) - Name of the token.
  - **tokenSymbol** (string) - Symbol of the token.
  - **listedMethod** (string) - Method by which the token was listed (INTERNAL, AI, EXTERNAL).
  - **unlockAmount** (number) - Amount of tokens unlocked.
  - **unlockValue** (number) - Value of the unlocked tokens.
  - **referencePrice** (number) - Reference price of the token.
  - **allocations** (array) - List of allocations for the emission.
    - **allocationName** (string) - Name of the allocation.
    - **standardAllocationName** (string) - Standard name for the allocation.
    - **unlockAmount** (number) - Amount unlocked for this allocation.
    - **unlockValue** (number) - Value unlocked for this allocation.
  - **totalCumulativeUnlockedAmount** (number) - Total cumulative unlocked amount for the token.

#### Response Example
```json
{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z"
  },
  "status": true,
  "data": [
    {
      "startDate": "2024-01-08T00:00:00Z",
      "endDate": "2024-01-09T00:00:00Z",
      "tokenName": "Arbitrum",
      "tokenSymbol": "ARB",
      "listedMethod": "INTERNAL",
      "unlockAmount": 478781.65471694345,
      "unlockValue": 818716.6295659733,
      "referencePrice": 1.71,
      "allocations": [
        {
          "allocationName": "Arbitrum DAO Treasury",
          "standardAllocationName": "Reserve",
          "unlockAmount": 478781.65471694345,
          "unlockValue": 818716.6295659733
        }
      ],
      "totalCumulativeUnlockedAmount": 1527949623.5683928
    }
  ]
}
```
```

--------------------------------

### Fetch Token List with Python

Source: https://docs.tokenomist.ai/

Retrieves a list of tokens and prints the name and circulating supply for the first five entries. Requires an API key passed in the headers.

```python
import requests

url = "https://api.tokenomist.ai/v4/token/list"
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
tokens = response.json()["data"]

for token in tokens[:5]:
    print(token["name"], token["circulatingSupply"])
```

--------------------------------

### Fetch Token List via API

Source: https://docs.tokenomist.ai/overview

Retrieves a list of tokens and prints the name and circulating supply for the first five entries. Requires a valid API key passed in the request headers.

```python
import requests

url = "https://api.tokenomist.ai/v4/token/list"
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
tokens = response.json()["data"]

for token in tokens[:5]:
    print(token["name"], token["circulatingSupply"])
```

```typescript
const response = await fetch(
  "https://api.tokenomist.ai/v4/token/list",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);

const { data: tokens } = await response.json();

tokens.slice(0, 5).forEach((token) => {
  console.log(token.name, token.circulatingSupply);
});
```

--------------------------------

### GET /v4/unlock/events

Source: https://docs.tokenomist.ai/api-documents/unlock-events/v4

Retrieves cliff unlock events for a specific token, including allocation breakdowns and valuation data.

```APIDOC
## GET /v4/unlock/events

### Description
Cliff unlocks only - removes start of Linear unlocks and mining rewards events.

### Method
GET

### Endpoint
/v4/unlock/events

### Parameters
#### Query Parameters
- **tokenId** (string) - Required - Token identifier. Get from Token List API.
- **start** (string) - Optional - Start date for time filtering (YYYY-MM-DD). Defaults to earliest available date.
- **end** (string) - Optional - End date for time filtering (YYYY-MM-DD). Defaults to furthest available date.

### Request Example
GET /v4/unlock/events?tokenId=arbitrum

### Response
#### Success Response (200)
- **metadata** (object) - Query metadata including queryDate.
- **status** (boolean) - Request status.
- **data** (array) - List of unlock events containing unlockDate, tokenName, tokenSymbol, listedMethod, dataSource, cliffUnlocks, and latestUpdateDate.
```

--------------------------------

### GET /v1/unlock/events/upcoming

Source: https://docs.tokenomist.ai/api-documents/upcoming-unlock-events/v1

Retrieves a list of upcoming token unlock events, sorted by time, with various filtering parameters.

```APIDOC
## GET /v1/unlock/events/upcoming

### Description
Retrieves upcoming unlock events sorted by upcoming time, similar to the Homepage view.

### Method
GET

### Endpoint
/v1/unlock/events/upcoming

### Parameters
#### Query Parameters
- **minMarketCap** (number) - Optional - Filter out tokens below a certain market cap
- **minReleasedPercentage** (number) - Optional - Filter out tokens below a certain percentage of released supply from 0-100
- **minUnlockDate** (string) - Optional - Start date for time filtering (YYYY-MM-DD)
- **maxUnlockDate** (string) - Optional - End date for time filtering (YYYY-MM-DD)
- **minTotalUnlockAmount** (number) - Optional - Filter out unlocks below a certain amount
- **minValueToMarketCap** (number) - Optional - Filter out unlocks below a certain value market cap from 0-100
- **standardAllocation** (string) - Optional - Filter the receiver's allocation (community, founderTeam, privateInvestors, publicInvestors, reserve, others)

### Response
#### Success Response (200)
- **metadata** (object) - Metadata object
- **status** (boolean) - Request status
- **data** (array) - List of unlock events

#### Response Example
{
  "status": true,
  "data": [
    {
      "tokenId": "layerzero",
      "tokenName": "LayerZero",
      "tokenSymbol": "ZRO",
      "marketCap": 278811255,
      "releasedPercentage": 35.2833333550565,
      "upcomingEvent": {
        "unlockDate": "2025-11-20T11:00:00Z",
        "referencePrice": 1.4
      }
    }
  ]
}
```

--------------------------------

### Submitting Feedback

Source: https://docs.tokenomist.ai/api-documents/investor-list/v1

Instructions for submitting feedback on the documentation.

```APIDOC
## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:
https://docs.tokenomist.ai/_mintlify/feedback/daosurv/agent-feedback

### Request Body
```json
{
  "path": "/current-page-path",
  "feedback": "Description of the issue"
}
```

**Note:** Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.
```