# GET /token/unlocks: $0.005 per call

Upcoming token unlocks for a project (vesting cliffs and emission changes): dates, amounts, % of supply, USD value at today's price, who receives them (team, investors, airdrop) and likely sell pressure, plus totals for the next 30 and 90 days. Pass ?protocol=arbitrum (DefiLlama slug or name)&days=90.

- **Price:** $0.005 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Answers cached for:** 1 hour(s)
- **Data sources:** DefiLlama emissions dataset (free); DefiLlama prices (free)
- **Lane:** Crypto & on-chain ([OpenAPI](/openapi/crypto.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/token-unlocks](/sample/token-unlocks). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/token-unlocks"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/token/unlocks?protocol=arbitrum&days=90&limit=20"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/token/unlocks?protocol=arbitrum&days=90&limit=20");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("token-unlocks", {"protocol":"arbitrum","days":90,"limit":20});
```

## Inputs

- `protocol` **(required)** (string): Project slug or name, e.g. arbitrum, optimism, aptos.
- `days` (integer; default `90`): Look ahead this many days.
- `limit` (integer; default `20`): Most unlock events to list.

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "protocol": "arbitrum",
  "name": "Arbitrum",
  "token": "arbitrum:0x912ce59144191c1204e64559fe8253a0e49e6548",
  "priceUsd": 0.39,
  "maxSupply": 10000000000,
  "next": {
    "date": "2026-10-16T13:20:33.000Z",
    "type": "cliff",
    "recipient": "insiders",
    "tokens": 56125000,
    "percentOfSupply": 0.561,
    "valueUsd": 21888750,
    "perWeek": false,
    "sellPressure": "high",
    "description": "On 2026-10-16 56,125,000 of Team, Contributors & Advisors tokens will be unlocked"
  },
  "next30d": {
    "tokens": 92645833,
    "percentOfSupply": 0.926,
    "valueUsd": 36131875,
    "insiderSharePercent": 100
  },
  "next90d": {
    "tokens": 277937500,
    "percentOfSupply": 2.779,
    "valueUsd": 108395625,
    "insiderSharePercent": 100
  },
  "unlocks": [],
  "allocation": {
    "insiders": [
      "Team, Contributors & Advisors"
    ],
    "privateSale": [
      "Investors"
    ]
  },
  "suggestions": [],
  "source": "DefiLlama emissions dataset",
  "checkedAt": "2026-09-28T12:00:00.000Z"
}
```

## Related

- [GET /token/price](/services/token-price) ($0.005): Live price of any token on Base, Solana, Ethereum, BNB, Arbitrum, Polygon, Optimism or Avalanche from DEX data: USD price, total liquidity, 24h volume, buys/sel
- [GET /token/safety](/services/token-safety) ($0.02): Rug-pull and scam check for any token on Base, Solana, Ethereum, BNB, Arbitrum, Polygon, Optimism or Avalanche.
- [GET /token/report/cached](/services/token-report-cached) ($0.05): Full token report, cached tier (answers up to 15 minutes old, half price): safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked 
- [GET /token/report](/services/token-report) ($0.10): Full token report, live: safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked share), liquidity (depth, locks, pools), price act
- [GET /token/report/deep](/services/token-report-deep) ($0.25): Deep token report: everything in /token/report (safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked share), liquidity (depth, l
- [GET /token/new](/services/token-new) ($0.01): New token launches with real liquidity: tokens whose first DEX pool opened in the last hour (up to 24h) with at least $10k liquidity (adjustable), newest first,
- [GET /token/whales](/services/token-whales) ($0.02): Whale and exchange flows for a token on Base, Ethereum, Arbitrum, Optimism or Polygon, from its latest ~250 transfers: large transfers, deposits/withdrawals per
- [GET /wallet](/services/wallet) ($0.01): Wallet profile on Base, Ethereum or Solana: native balance, token holdings with USD values (top 25), total portfolio value, whether it is a contract, ENS name, 

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).