List individual SOL stake account unlocks in a date range, largest first within each time.
solana_unlocks_list_unlocksList individual SOL stake account unlocks in a date range, largest first within each time. Dates from and to are YYYY-MM-DD, inclusive (default today and 30 days on). Filters: min_sol, withdraw_authority (whose SOL it is) and custodian (who can lift the lockup). Each row gives the stake account, SOL, unlock time, withdraw authority, custodian and the vote account it is delegated to (null if not delegated). Returns up to limit rows (default 50, max 200) and the matched count and SOL. Costs $0.002 per call, paid via x402 in USDC on Base; the first 3 paid-tool calls per day are free for MCP clients while a shared daily allowance lasts. Without x402 support, later calls return the payment requirements as an error result. Failed calls are not charged. Source: Solana mainnet-beta (stake account lockups via JSON-RPC), Public on-chain data.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "solana_unlocks_list_unlocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last date, YYYY-MM-DD (default from + 29 days) (e.g. 2026-12-31) | |
| from | No | First date, YYYY-MM-DD (default today) (e.g. 2026-12-01) | |
| limit | No | Rows to return, 1 to 200 (default 50) (e.g. 20) | |
| min_sol | No | Only unlocks of at least this many SOL (e.g. 10000) | |
| custodian | No | Only lockups with this custodian (base58) | |
| withdraw_authority | No | Only stake accounts with this withdraw authority (base58) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Result: a list of applications for search and nearby tools, one record or summary object otherwise | |
| meta | Yes | Paging and query details, e.g. limit, offset, has_more, count | |
| attribution | Yes | Source attribution; keep it when presenting the data |