Skip to main content
GET
/
v1
/
unlock
/
events
/
upcoming
curl -X 'GET' \
  'https://api.unlocks.app/v1/unlock/events/upcoming' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2025-11-20T07:22:41Z"
    },
    "status": true,
    "data": [
        {
            "tokenId": "layerzero",
            "tokenName": "LayerZero",
            "tokenSymbol": "ZRO",
            "marketCap": 278811255,
            "releasedPercentage": 35.2833333550565,
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "upcomingEvent": {
                "unlockDate": "2025-11-20T11:00:00Z",
                "referencePrice": 1.4,
                "referencePriceUpdatedTime": "2025-11-20T00:00:00Z",
                "cliffUnlocks": {
                    "totalCliffAmount": 25708332.666,
                    "totalCliffValue": 35991665.7324,
                    "valueToMarketCap": 12.908971602455575,
                    "allocationBreakdown": [
                        {
                            "allocationName": "Core Contributors",
                            "standardAllocationName": "Founder / Team",
                            "cliffAmount": 10625000,
                            "cliffValue": 14874999.999999998,
                            "unlockPrecision": "month"
                        }
                    ]
                },
                "latestUpdateDate": "2025-06-13T07:30:52Z"
            }
        }
    ]
}
This endpoint is the timestamp information of the upcoming unlock events. This dataset is the same scheme to Unlock Events API but sort by upcoming time, similar Homepage

​
Query Parameters

​
minMarketCap
number
Filter out tokens below a certain market cap
​
minReleasedPercentage
number
Filter out tokens below a certain percentage of released supply from 0-100
​
minUnlockDate
string
The start date for time filtering in the format YYYY-MM-DD. Defaults is the earliest available date.
​
maxUnlockDate
string
The end date for time filtering in the format YYYY-MM-DD. Defaults is the furthest available date.
​
minTotalUnlockAmount
number
Filter out unlocks below a certain amount
​
minValueToMarketCap
number
Filter out unlocks below a certain value market cap from 0-100
​
standardAllocation
string
Filter the receiver’s allocation. Choose from these enums, can be multi-select: community, founderTeam, privateInvestors, publicInvestors, reserve, others

​
Response

​
metadata
object
​
status
boolean
Request status
​
data
object[]
curl -X 'GET' \
  'https://api.unlocks.app/v1/unlock/events/upcoming' \
  -H 'x-api-key: $YOUR_API_KEY'

{
    "metadata": {
        "queryDate": "2025-11-20T07:22:41Z"
    },
    "status": true,
    "data": [
        {
            "tokenId": "layerzero",
            "tokenName": "LayerZero",
            "tokenSymbol": "ZRO",
            "marketCap": 278811255,
            "releasedPercentage": 35.2833333550565,
            "listedMethod": "INTERNAL",
            "dataSource": "Whitepaper",
            "upcomingEvent": {
                "unlockDate": "2025-11-20T11:00:00Z",
                "referencePrice": 1.4,
                "referencePriceUpdatedTime": "2025-11-20T00:00:00Z",
                "cliffUnlocks": {
                    "totalCliffAmount": 25708332.666,
                    "totalCliffValue": 35991665.7324,
                    "valueToMarketCap": 12.908971602455575,
                    "allocationBreakdown": [
                        {
                            "allocationName": "Core Contributors",
                            "standardAllocationName": "Founder / Team",
                            "cliffAmount": 10625000,
                            "cliffValue": 14874999.999999998,
                            "unlockPrecision": "month"
                        }
                    ]
                },
                "latestUpdateDate": "2025-06-13T07:30:52Z"
            }
        }
    ]
}