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

# Upcoming Unlock Events v5

`GET /v5/unlock/events/upcoming`

Upcoming unlock events sorted by upcoming time. v5 renames the date params (start/end), adds pagination, and recalculates cliff aggregates after standardAllocation filtering.

## Query parameters

- `minMarketCap` number
- `minReleasedPercentage` number
- `start` string, date
- `end` string, date
- `minTotalUnlockAmount` number
- `minValueToMarketCap` number
- `standardAllocation` string
- `page` integer
- `pageSize` integer

## Response `200`

Successful response

- object
  - `metadata` PaginatedMetadata
    - `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 — Requests counted in the current window (approximate / eventually consistent).
      - `limit` integer — The plan's request quota for the window.
      - `resetAt` string, date-time — When the quota resets (RFC3339 UTC). Present for monthly plans; absent for lifetime-quota plans.
    - `page` integer — Current page number (1-indexed)
    - `pageSize` integer — Number of items per page
    - `totalPages` integer — Total number of pages available for the current query
    - `total` integer — Total number of items across all pages
  - `status` boolean
  - `data` UpcomingUnlockEventV5Item[]
    - `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` CliffUnlocksV5
        - `cliffAmount` number — Total Unlock Amount Denominated in token
        - `cliffValue` number — Total Unlock Value Denominated in USD
        - `valueToMarketCap` number — Value / M.Cap in Percentage
        - `allocationBreakdown` CliffAllocationBreakdownV5[]
          - `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
          - `committedClaim` CommittedClaim, nullable — Committed claim information for the allocation. Null when no committed claim data is available.
            - `amount` number, nullable — Committed claim amount denominated in token
            - `value` number, nullable — Committed claim value denominated in USD
            - `timestamp` integer, nullable — Unix timestamp of the committed claim
      - `latestUpdateDate` string, date-time

---

[API](https://skmtc.net/tokenomist/apis/tokenomist-api.md) · [All operations](https://skmtc.net/tokenomist/apis/tokenomist-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tokenomist/tokenomist-api/versions/1d812f25c55a/schema)