---
title: "Get Unlock Timeseries Data per Interval"
method: GET
path: "/token-unlocks/v1/assets/{assetId}/unlocks"
tags: ["token-unlocks/Assets"]
---

# Get Unlock Timeseries Data per Interval

`GET /token-unlocks/v1/assets/{assetId}/unlocks`

## Request

- Base URL: `https://api.messari.io`
- URL: `https://api.messari.io/token-unlocks/v1/assets/{assetId}/unlocks`
- Auth: API key in header `X-Messari-API-Key`
- TypeScript: <https://skmtc.dev/messari/apis/messari-api-deep-research-v1/docs/token-unlocks/v1/assets/:assetId/unlocks/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns interval-based unlock timeseries data for a given asset and interval

## Path parameters

- `assetId` string, required

## Query parameters

- `startTime` string, date-time
- `endTime` string, date-time
- `interval` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY', required

## Response `200`

Default response

- object
  - `data` Unlock, required
    - `allocations` AllocationUnlockTranche[], required
    - `asset` AssetBasic, required: Schema for AssetBasic
    - `endDate` string, date-time, required
    - `genesisDate` string, date-time
    - `interval` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'QUARTERLY' | 'YEARLY', required
    - `projectedEndDate` string, date-time
    - `startDate` string, date-time, required
    - `totalSnapshots` UnlockSnapshot[], required
  - `error` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/messari/apis/messari-api-deep-research-v1.md) - [All operations](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/messari/apis/messari-api-deep-research-v1/revisions/af35b9757e14?raw)