Unlock events as of a date

curl --request GET \
  --url https://api.tokenomist.ai/v5/point-in-time/unlock/events/{tokenId} \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.tokenomist.ai/v5/point-in-time/unlock/events/{tokenId}', 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/point-in-time/unlock/events/{tokenId}",
  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/point-in-time/unlock/events/{tokenId}"

	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/point-in-time/unlock/events/{tokenId}")

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-10-29T06:24:37Z",
    "asOf": "2025-01-01T00:00:00Z",
    "version": {
      "id": "eigenlayer-p-6703562619635290c11ad65a",
      "historyOrder": 4,
      "validFrom": "2024-10-04T04:52:36Z",
      "validFromBasis": "stated_in_document",
      "validUntil": null,
      "previousVersionId": "eigenlayer-p-66fa656ce4a4901842303dd6",
      "status": "current"
    },
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 20,
    "totalPages": 2,
    "total": 27
  },
  "status": true,
  "data": [
    {
      "unlockDate": "2024-10-15T19:00:00Z",
      "tokenName": "EigenCloud (prev. EigenLayer)",
      "tokenSymbol": "EIGEN",
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "cliffUnlocks": {
        "cliffAmount": 11218945.71,
        "allocationBreakdown": [
          {
            "unlockDate": "2024-10-15T19:00:00Z",
            "allocationName": "Future community initiatives",
            "standardAllocationName": "Community",
            "cliffAmount": 11218945.71,
            "unlockPrecision": "second",
            "committedClaim": {
              "amount": 1234567.89,
              "timestamp": 1735689600
            }
          }
        ]
      }
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

GET

point-in-time

unlock

events

{tokenId}

Unlock events as of a date

curl --request GET \
  --url https://api.tokenomist.ai/v5/point-in-time/unlock/events/{tokenId} \
  --header 'x-api-key: <api-key>'

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

fetch('https://api.tokenomist.ai/v5/point-in-time/unlock/events/{tokenId}', 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/point-in-time/unlock/events/{tokenId}",
  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/point-in-time/unlock/events/{tokenId}"

	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/point-in-time/unlock/events/{tokenId}")

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-10-29T06:24:37Z",
    "asOf": "2025-01-01T00:00:00Z",
    "version": {
      "id": "eigenlayer-p-6703562619635290c11ad65a",
      "historyOrder": 4,
      "validFrom": "2024-10-04T04:52:36Z",
      "validFromBasis": "stated_in_document",
      "validUntil": null,
      "previousVersionId": "eigenlayer-p-66fa656ce4a4901842303dd6",
      "status": "current"
    },
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    },
    "page": 1,
    "pageSize": 20,
    "totalPages": 2,
    "total": 27
  },
  "status": true,
  "data": [
    {
      "unlockDate": "2024-10-15T19:00:00Z",
      "tokenName": "EigenCloud (prev. EigenLayer)",
      "tokenSymbol": "EIGEN",
      "listedMethod": "INTERNAL",
      "dataSource": "Whitepaper",
      "cliffUnlocks": {
        "cliffAmount": 11218945.71,
        "allocationBreakdown": [
          {
            "unlockDate": "2024-10-15T19:00:00Z",
            "allocationName": "Future community initiatives",
            "standardAllocationName": "Community",
            "cliffAmount": 11218945.71,
            "unlockPrecision": "second",
            "committedClaim": {
              "amount": 1234567.89,
              "timestamp": 1735689600
            }
          }
        ]
      }
    }
  ]
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

{
  "metadata": {
    "queryDate": "2026-10-29T06:25:07Z",
    "credit": {
      "used": 213,
      "limit": 1000,
      "resetAt": "2026-08-01T00:00:00Z"
    }
  },
  "status": false,
  "statusCode": 404,
  "errorCode": "TOKEN_NOT_FOUND",
  "errorMessage": "Token not found",
  "earliestValidDate": "2023-10-29T00:00:00Z"
}

Same shape as Unlock Events v5, answered by the version you select with asOf or versionId. See version selector. Cliff events only, as in v5. Continuous releases are in Daily emission as of a date. Differences from v5:

metadata.asOf and metadata.version report which version answered.
Events after asOf are returned too: they were the forecast at asOf. Compare unlockDate with metadata.asOf to tell them apart.
committedClaim includes only claims with a timestamp on or before asOf, and has no USD value.
USD fields (cliffValue, referencePrice, valueToMarketCap) and referencePriceUpdatedTime are not returned.
latestUpdateDate is removed. Use metadata.version instead.

start, end, standardAllocation, page and pageSize work as in v5: an unlock at 00:00 UTC on the end date is included, and a page holds 20 dates by default. The plan window for start and end is counted from today, not from asOf.

Example

curl --fail-with-body -s \
  "https://api.tokenomist.ai/v5/point-in-time/unlock/events/eigenlayer?asOf=2025-01-01&start=2025-01-01&end=2026-01-01" \
  -H "x-api-key: YOUR_API_KEY"

EigenLayer’s project version 4 (announced on 2024-10-04), first event in the range:

{
  "unlockDate": "2025-01-07T19:00:00Z",
  "tokenName": "EigenCloud (prev. EigenLayer)",
  "tokenSymbol": "EIGEN",
  "listedMethod": "INTERNAL",
  "dataSource": "Whitepaper",
  "cliffUnlocks": {
    "cliffAmount": 1287420,
    "allocationBreakdown": [
      {
        "unlockDate": "2025-01-07T19:00:00Z",
        "allocationName": "Future community initiatives",
        "standardAllocationName": "Community",
        "cliffAmount": 1287420,
        "unlockPrecision": "second",
        "committedClaim": null
      }
    ]
  }
}

To see how every version described the same events, call this endpoint once per versionId from Token versions.

Authorizations

x-api-key

string

header

required

Your Tokenomist API key

Path Parameters

tokenId

string

required

Token identifier (slug), as in Token List v5. A token not in that list answers 404 TOKEN_NOT_FOUND.

Query Parameters

asOf

string

Decision time T, as an RFC 3339 datetime or YYYY-MM-DD (00:00:00 UTC that day). Returns the project version in force at T. Defaults to now, which returns the current version. A future date returns 400 INVALID_AS_OF. Cannot be combined with versionId (422 INVALID_PARAMETER). Your plan sets how far back it can go.

versionId

string

A project version id from the token versions endpoint, for example eigenlayer-p-6703562619635290c11ad65a. Returns that version, evaluated at its start or at the start of your plan's range, whichever is later. Cannot be combined with asOf (422 INVALID_PARAMETER).

start

string<date>

Start date (YYYY-MM-DD), as in v5. Must be inside your plan's window, which is counted from today, not from asOf.

end

string<date>

End date (YYYY-MM-DD), as in v5: an unlock at 00:00 UTC that day is included. Can be later than asOf.

standardAllocation

string

Comma-separated list of standard allocations to filter by. Allowed values: community, founderTeam, privateInvestors, publicInvestors, others, reserve. An unknown value or an empty item (for example a trailing comma): 422; an empty parameter is ignored. Aggregates (unlockAmount, totalCumulativeUnlockedAmount, cliffAmount, committedClaim) are recalculated from the kept allocations.

page

integer

Page number (1-indexed). 0 or omitted means 1.

Required range: x >= 0

pageSize

integer

Number of items per page. 0 or omitted means 20.

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 as of a date

Example

Authorizations

Path Parameters

Query Parameters

Response

​Example

Authorizations

Path Parameters

Query Parameters

Response

Example