# Messari Token Unlock History

> Messari Token Unlock History is a paid API for AI agents from api.messari.io, paid per call via x402, $0.75/call, status unknown (last checked 2026-09-15).

Retrieves historical token unlock records for a specific crypto asset, including dates, amounts, USD values, and cumulative unlocked totals.

## Facts

- Endpoint: GET https://api.messari.io/token-unlocks/v1/assets/*/unlocks
- Price: $0.75/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/messari-token-unlock-history-c0024798
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_507OZJ4B2YHq7bHvzgqlv

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability messari-token-unlock-history-c0024798
```

Example prompt: Pull the Messari token unlock history for Arbitrum (ARB) from January 1, 2025 to March 31, 2025 so I can see how many tokens were released each month and the cumulative unlocked supply.

## When to prefer this

Use this endpoint when you need time-series data on past token unlock events for a specific crypto asset, including USD valuations and cumulative supply release totals. Ideal for analyzing vesting schedules, supply inflation pressure, or comparing unlock cadences across date ranges. Prefer this over real-time or scheduled unlock endpoints when historical context or trend analysis is needed.

## Known failure modes

- Invalid or unrecognized asset ID returns a 404 or empty data array
- Date range outside available data coverage returns empty results
- Malformed date format (not ISO 8601) may return a 400 bad request
- Missing required assetId path parameter returns a 400 or 422 error
- Payment not processed (x402) results in a 402 Payment Required response
- Rate limiting or quota exceeded returns a 429 response

## How this service works

Get historical token unlock records for a specific crypto asset.

## Output

Returns an array of historical unlock records for the specified asset, each containing the date of the unlock, the amount of tokens unlocked, the USD equivalent at that time, and the cumulative total of tokens unlocked to date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "assetId"
 ],
 "properties": {
  "assetId": {
   "type": "string",
   "description": "Asset identifier in the route path."
  },
  "endDate": {
   "type": "string"
  },
  "startDate": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "example": {
  "data": [
   {
    "date": "2025-03-01",
    "amount": 1200000,
    "assetId": "bitcoin",
    "amountUsd": 72000000,
    "cumulativeUnlocked": 5800000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/messari-token-unlock-history-c0024798/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.messari.io](https://www.zero.xyz/host/api.messari.io/llms.txt)