Skip to main content
GET
/
token-unlocks
/
v1
/
assets
Get Filtered Assets with Allocation information
curl --request GET \
  --url https://api.messari.io/token-unlocks/v1/assets \
  --header 'X-Messari-API-Key: <api-key>'
{
  "error": null,
  "data": [
    {
      "id": "1c077d6e-99c7-491c-b24d-1d359011cd81",
      "serialId": 609,
      "symbol": "TRX",
      "name": "TRON",
      "genesisDate": "2017-09-13T00:00:00Z",
      "projectedEndDate": "2017-09-13T00:00:00Z",
      "slug": "tron",
      "category": "Networks",
      "sector": "Smart Contract Platform",
      "tags": [
        "EVM",
        "Proof-of-Stake",
        "SEC Alleged Securities",
        "Stakeable"
      ],
      "otherInfo": null
    },
    {
      "id": "7c435a77-5be9-4424-b5d1-1c02b968c56f",
      "serialId": 378,
      "symbol": "XLM",
      "name": "Stellar",
      "genesisDate": "2015-11-24T00:00:00Z",
      "projectedEndDate": "2023-04-05T00:00:00Z",
      "slug": "stellar",
      "category": "Financial Services",
      "sector": "Payments",
      "tags": null,
      "otherInfo": null
    },
    {
      "id": "99b6a5f4-2200-4098-82fd-53d091bdee70",
      "serialId": 756013,
      "symbol": "HYPE",
      "name": "Hyperliquid",
      "genesisDate": "2024-11-29T00:00:00Z",
      "projectedEndDate": "2027-10-28T00:00:00Z",
      "slug": "hyperliquid",
      "category": "Marketplaces",
      "sector": "Exchange",
      "tags": [
        "Decentralized Exchange",
        "DeFi",
        "Perpetuals"
      ],
      "otherInfo": null
    },
    {
      "id": "78c4b0c5-8cbe-4f05-b639-0eb942e86dd5",
      "serialId": 21023,
      "symbol": "SUI",
      "name": "Sui",
      "genesisDate": "2023-05-01T00:00:00Z",
      "projectedEndDate": "2030-05-01T00:00:00Z",
      "slug": "sui",
      "category": "Networks",
      "sector": "Smart Contract Platform",
      "tags": null,
      "otherInfo": "Sui unlock data is only supported up to 2030 (47.83% of the total allocation), as the project only released data for the next 7 years; therefore, the unlock data for Mysten Labs Treasury, Early Contributors, Community Reserve is incomplete in the vesting schedule. Furthermore, tokens allocated to inflationary categories (Stake Subsidies) are not accounted for in the unlock data below. "
    },
    {
      "id": "2db6b38a-681a-4514-9d67-691e319597ee",
      "serialId": 1265,
      "symbol": "AVAX",
      "name": "Avalanche",
      "genesisDate": "2020-09-21T00:00:00Z",
      "projectedEndDate": "2030-07-20T00:00:00Z",
      "slug": "avalanche",
      "category": "Networks",
      "sector": "Layer-0",
      "tags": [
        "Proof-of-Stake",
        "Stakeable"
      ],
      "otherInfo": null
    }
  ]
}

Authorizations

X-Messari-API-Key
string
header
required

Query Parameters

page
integer
default:1

Page number for pagination

Example:

1

limit
integer
default:10

Number of results per page

Example:

10

assetIDs
string
default:7e532302-9ced-4e90-8c8a-218a38e1dbba,1c077d6e-99c7-491c-b24d-1d359011cd81

Comma-separated list of asset IDs (UUIDs) to filter by

Example:

"7e532302-9ced-4e90-8c8a-218a38e1dbba,1c077d6e-99c7-491c-b24d-1d359011cd81"

category
string
default:Networks,DeFi

Comma-separated list of categories to filter by

Example:

"Networks,DeFi"

sector
string
default:Smart Contract Platform

Comma-separated list of sectors to filter by

Example:

"Smart Contract Platform"

tags
string
default:Proof-of-Stake,EVM

Comma-separated list of tags to filter by

Example:

"Proof-of-Stake,EVM"

Response

Default response

data
object[]
required
error
string