---
title: "Upcoming Unlock Events"
method: GET
path: "/v1/unlock/events/upcoming"
tags: ["Upcoming Unlock Events"]
---

# Upcoming Unlock Events

`GET /v1/unlock/events/upcoming`

## Request

- Base URL: `https://api.tokenomist.ai`
- URL: `https://api.tokenomist.ai/v1/unlock/events/upcoming`
- Auth: API key in header `x-api-key`

Upcoming unlock events sorted by upcoming time, similar to Homepage.

## Query parameters

- `minMarketCap` number
- `minReleasedPercentage` number
- `minUnlockDate` string, date
- `maxUnlockDate` string, date
- `minTotalUnlockAmount` number
- `minValueToMarketCap` number
- `standardAllocation` string

## Response `200`

Successful response

- object
  - `metadata` Metadata
    - `queryDate` string, date-time: Timestamp of the query
    - `credit` Credit: 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.
      - `used` integer: 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.
      - `limit` integer: The plan's request quota for the window.
      - `resetAt` string, date-time: When the quota resets: the 1st of next month, 00:00 UTC (RFC 3339).
  - `status` boolean
  - `data` object[]
    - `tokenId` string
    - `tokenName` string
    - `tokenSymbol` string
    - `marketCap` number, nullable
    - `releasedPercentage` number
    - `listedMethod` string
    - `dataSource` string
    - `upcomingEvent` object
      - `unlockDate` string, date-time
      - `referencePrice` number
      - `referencePriceUpdatedTime` string, date-time
      - `cliffUnlocks` object
        - `totalCliffAmount` number
        - `totalCliffValue` number
        - `valueToMarketCap` number
        - `allocationBreakdown` CliffAllocationBreakdown[]
          - `unlockDate` string, date-time: Cliff unlock date
          - `allocationName` string: Allocation Name
          - `standardAllocationName` string: Standard allocation of this allocation
          - `cliffAmount` number: Unlock Amount Denominated in Token
          - `cliffValue` number: Unlock Value Denominated in USD
          - `referencePrice` number: Reference Price used in total unlocks value calculation
          - `referencePriceUpdatedTime` string, date-time: Reference Price Last Updated Time
          - `unlockPrecision` string: Precision of Unlock. Example: second, hour, day, week, unknown(for AI listed token only), etc
      - `latestUpdateDate` string, date-time

---

[API](https://skmtc.dev/tokenomist/apis/tokenomist-api.md) - [All operations](https://skmtc.dev/tokenomist/apis/tokenomist-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tokenomist/apis/tokenomist-api/revisions/37c15ea7bdbd?raw)