Unlock Events List API v5

Unlock Events List v5

curl --request GET \
  --url https://api.tokenomist.ai/v5/unlock/events/list \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.tokenomist.ai/v5/unlock/events/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tokenomist.ai/v5/unlock/events/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tokenomist.ai/v5/unlock/events/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tokenomist.ai/v5/unlock/events/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 50,
    "totalPages": 10,
    "total": 487
  },
  "status": true,
  "data": [
    {
      "tokenId": "layerzero",
      "tokenName": "LayerZero",
      "tokenSymbol": "ZRO",
      "marketCap": 278811255,
      "releasedPercentage": 35.28,
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "events": [
        {
          "unlockDate": "2025-11-20T11:00:00Z",
          "referencePrice": 1.4,
          "referencePriceUpdatedTime": "2025-11-20T11:00:00Z",
          "cliffUnlocks": {
            "totalCliffAmount": 92645833.3,
            "totalCliffValue": 129704166.62,
            "valueToMarketCap": 46.52,
            "allocationBreakdown": [
              {
                "allocationName": "Strategic Partners",
                "standardAllocationName": "Private Investors",
                "cliffAmount": 92645833.3,
                "cliffValue": 129704166.62,
                "unlockPrecision": "second"
              }
            ]
          },
          "latestUpdateDate": "2025-06-13T07:30:52Z"
        }
      ]
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

GET

unlock

events

list

Unlock Events List v5

curl --request GET \
  --url https://api.tokenomist.ai/v5/unlock/events/list \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.tokenomist.ai/v5/unlock/events/list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tokenomist.ai/v5/unlock/events/list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tokenomist.ai/v5/unlock/events/list"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tokenomist.ai/v5/unlock/events/list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "queryDate": "2026-01-08T10:13:58Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 50,
    "totalPages": 10,
    "total": 487
  },
  "status": true,
  "data": [
    {
      "tokenId": "layerzero",
      "tokenName": "LayerZero",
      "tokenSymbol": "ZRO",
      "marketCap": 278811255,
      "releasedPercentage": 35.28,
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "events": [
        {
          "unlockDate": "2025-11-20T11:00:00Z",
          "referencePrice": 1.4,
          "referencePriceUpdatedTime": "2025-11-20T11:00:00Z",
          "cliffUnlocks": {
            "totalCliffAmount": 92645833.3,
            "totalCliffValue": 129704166.62,
            "valueToMarketCap": 46.52,
            "allocationBreakdown": [
              {
                "allocationName": "Strategic Partners",
                "standardAllocationName": "Private Investors",
                "cliffAmount": 92645833.3,
                "cliffValue": 129704166.62,
                "unlockPrecision": "second"
              }
            ]
          },
          "latestUpdateDate": "2025-06-13T07:30:52Z"
        }
      ]
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-11-03T09:10:52Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 403,
  "errorMessage": "This token is not supported",
  "data": [
    {
      "key": "<string>",
      "value": "<unknown>",
      "message": "<string>"
    }
  ]
}

Cliff unlock events of every token between minUnlockDate and maxUnlockDate, grouped by token and sorted by tokenId. Both dates default to your plan’s window, counted from today. Use the filters to keep large or high-impact unlocks only. For one token’s events, use Unlock Events v5.

Authorizations

x-api-key

string

header

required

Your Tokenomist API key

Query Parameters

minUnlockDate

string<date>

Earliest unlock date (YYYY-MM-DD). Defaults to the start of your plan's window (today minus its years back). Outside the window: 422 "unlock date must be within the allowed range: A to B".

maxUnlockDate

string<date>

Latest unlock date (YYYY-MM-DD) = 00:00 UTC that day: an unlock at exactly 00:00 is included, a later one that day is not. Defaults to the end of your plan's window (today plus its years ahead). Outside the window, or before minUnlockDate: 422.

minMarketCap

number

Minimum current market cap, in USD. When set, tokens without a market cap are left out.

minReleasedPercentage

number

Minimum releasedPercentage of the token, in percent (0-100).

minTotalUnlockAmount

number

Keep only events whose totalCliffAmount is at least this many tokens (not USD).

minValueToMarketCap

number

Keep only events whose valueToMarketCap is at least this percent (5 means 5%). When set, events without a market cap are left out.

standardAllocation

string

Comma-separated standard allocations to keep. Allowed values: community, founderTeam, privateInvestors, publicInvestors, others, reserve; another value: 422. An event without a matching allocation is dropped; totalCliffAmount and totalCliffValue are recalculated from the kept allocations, valueToMarketCap is not.

page

integer

Page number, 1-based. 0 or omitted: page 1. A page past the last returns the last page again, so stop at metadata.totalPages. Negative: 400.

Required range: x >= 0

pageSize

integer

Rows per page. 0 or omitted: 20. No maximum. Negative: 400.

Required range: x >= 0

Response

Successful response

metadata

object

Show child attributes

status

boolean

data

object[]

Show child attributes

Get started

Core concepts

Token List

Allocations

Daily Emission

Unlock Events

Fundraising

Burn

Buyback

Point-in-Time History

Deprecated versions

Unlock Events List API v5

Authorizations

Query Parameters

Response