# Messari Token Unlocks — Allocation Breakdowns

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

Returns token allocation breakdowns by category (e.g. team, investors) and vesting bucket for a given crypto asset.

## Facts

- Endpoint: GET https://api.messari.io/token-unlocks/v1/allocations
- Price: $0.25/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-unlocks-allocation-breakdowns-b5e76fad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XvTxBiXHi0YqGv1xjEWEV

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-unlocks-allocation-breakdowns-b5e76fad
```

Example prompt: Pull the Messari token allocation breakdown for Solana — show me how the supply is split across categories like team and investors, including vesting start and end dates. Give me the first page with up to 10 results.

## When to prefer this

Use this endpoint when you need structured, institutional-grade token vesting and allocation data broken down by stakeholder category for a specific crypto asset. Prefer this over generic crypto APIs when you need vesting bucket granularity (start/end dates per category) rather than just circulating supply figures.

## Known failure modes

- Unknown or invalid assetId returns empty data array or 404
- Exceeding rate limits or unpaid x402 payment results in 402 Payment Required
- Invalid pagination parameters (page < 1 or limit < 1) may return 400 Bad Request
- Asset with no unlock data returns empty allocations array

## How this service works

Get token allocation breakdowns by category and vesting bucket.

## Output

A paginated list of allocation records for the specified crypto asset, each containing the category (e.g. 'team', 'investors'), total amount allocated, percentage of total supply, and vesting start/end dates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "minimum": 1
  },
  "limit": {
   "type": "integer",
   "minimum": 1
  },
  "assetId": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "example": {
  "data": [
   {
    "assetId": "bitcoin",
    "assetName": "Bitcoin",
    "allocations": [
     {
      "amount": 2500000,
      "category": "team",
      "vestingEnd": "2028-01-01",
      "vestingStart": "2024-01-01",
      "percentOfSupply": 2.5
     }
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/messari-token-unlocks-allocation-breakdowns-b5e76fad/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)