> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt > Use this file to discover all available pages before exploring further. # List Covered Assets > Every asset with token unlock coverage, filterable by category, sector, tags, or asset UUID. ## OpenAPI ````yaml api-reference/token-unlocks/openapi.json GET /token-unlocks/v1/assets openapi: 3.0.0 info: title: Blockworks Token Unlocks API description: OpenAPI specification for the Blockworks Token Unlocks API. version: 1.0.0 servers: - url: https://api.blockworks.com description: Blockworks API security: - apiKey: [] tags: - name: Assets description: Coverage, unlock events, and the two timeseries views. - name: Allocations description: Who holds what, and how much of it has unlocked. paths: /token-unlocks/v1/assets: get: tags: - Assets summary: List covered assets description: >- Every asset with token unlock coverage, with the classification fields the other endpoints key off. Filters combine with AND across parameters and OR within a comma-separated parameter. The full corpus is a few hundred assets and the response is unordered, so sort client-side if you need stable ordering. operationId: getFilteredAssets parameters: - name: assetIDs in: query description: >- Comma-separated asset UUIDs. Slugs are not accepted here and match nothing; use the per-asset endpoints for slug lookups. schema: type: string example: >- b3d5d66c-26a2-404c-9325-91dc714a722b,1c077d6e-99c7-491c-b24d-1d359011cd81 - name: category in: query description: Comma-separated categories, matched as OR. schema: type: string example: Networks,Financial Services - name: sector in: query description: Comma-separated sectors, matched as OR. schema: type: string example: Smart Contract Platform - name: tags in: query description: Comma-separated tags, matched as OR. schema: type: string example: EVM,Proof-of-Stake - name: page in: query description: >- Accepted but not currently applied. The endpoint returns the full matching set regardless of this value. schema: type: integer example: 1 - name: limit in: query description: >- Accepted but not currently applied. The endpoint returns the full matching set regardless of this value. schema: type: integer example: 10 responses: '200': description: >- Assets matching the filters. `data` is `null`, not `[]`, when nothing matches. content: application/json: schema: type: object properties: error: type: string nullable: true description: '`null` on success.' data: type: array nullable: true items: $ref: '#/components/schemas/UnlockAsset' required: - data example: error: null data: - id: b3d5d66c-26a2-404c-9325-91dc714a722b serialId: 6079 symbol: SOL name: Solana genesisDate: '2020-04-07T00:00:00Z' projectedEndDate: '2029-03-01T00:00:00Z' slug: solana category: Networks sector: Smart Contract Platform tags: - Proof-of-Stake - SEC Alleged Securities - Stakeable otherInfo: >- Tokens allocated to inflationary categories (Validator Rewards) are not accounted for in the unlock data below. - id: 78c4b0c5-8cbe-4f05-b639-0eb942e86dd5 serialId: 21023 symbol: SUI name: Sui genesisDate: '2023-04-30T00:00:00Z' projectedEndDate: '2030-04-28T00: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: 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: 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 '400': description: >- Malformed request, for example an `interval` outside the allowed set or an unparseable timestamp. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Missing or invalid API key, or a key without token unlock access. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Server error. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: UnlockAsset: type: object description: >- An asset with token unlock coverage, including the classification fields the list endpoint filters on. properties: id: type: string format: uuid description: Asset UUID, shared across Blockworks APIs. example: 1c077d6e-99c7-491c-b24d-1d359011cd81 serialId: type: integer format: int32 description: Stable internal sequence number for the asset. example: 609 symbol: type: string description: Ticker symbol. example: TRX name: type: string description: Display name. example: TRON slug: type: string description: >- URL-safe identifier. Accepted as `assetId` on the per-asset endpoints, but not by the `assetIDs` filter here. example: tron genesisDate: type: string format: date-time description: Date the token's vesting timeline begins. example: '2017-09-13T00:00:00Z' projectedEndDate: type: string format: date-time description: >- Date the last scheduled unlock is projected to land. Equal to `genesisDate` for assets whose allocation unlocked at genesis. example: '2017-09-13T00:00:00Z' category: type: string description: >- Top-level classification. Empty string when the asset is unclassified. example: Networks sector: type: string description: >- Sector within the category. Empty string when the asset is unclassified. example: Smart Contract Platform tags: type: array nullable: true description: Descriptive tags. `null`, not `[]`, when the asset carries none. items: type: string example: - EVM - Proof-of-Stake - Stakeable otherInfo: type: string nullable: true description: >- Analyst caveat about the coverage of this asset's unlock data, for example a schedule the project has only published through a given year. `null` for most assets. Read it before treating a schedule as complete. example: null required: - id - serialId - symbol - name - slug - category - sector Error: type: object description: Failure envelope. `error` carries the message and `data` is `null`. properties: error: type: string description: Error message. example: invalid auth mechanism data: nullable: true description: Always `null` on failure. required: - data securitySchemes: apiKey: type: apiKey in: header name: X-Blockworks-API-Key ````