# SOL stake unlock calendar

When locked SOL becomes withdrawable: every mainnet stake account whose lockup has not expired, with amount, unlock time, withdraw authority, custodian and delegation. Daily, weekly or monthly totals, and the individual unlocks with filters. Read from chain state hourly.

## Endpoints

### GET /v1/solana-unlocks/summary

Get how much SOL is still locked in stake account lockups and how much unlocks soon.

Returns the locked SOL total (and the delegated part), the next unlock day, the SOL unlocking in the next 7, 30, 90 and 365 days, and the last unlock date. Use solana_unlocks_get_unlock_calendar for the schedule.

MCP tool: `solana_unlocks_get_unlock_summary`

Price: free

### GET /v1/solana-unlocks/calendar

Get the SOL unlock schedule by day, week or month for a date range.

Dates from and to are YYYY-MM-DD, inclusive (default today and 90 days on, span up to 1,500 days). The group parameter is day (default), week (starting Monday) or month. Each period gives the SOL whose stake lockup ends then, the number of stake accounts, the delegated part (needs about one epoch to deactivate before withdrawal) and the largest single account. Periods with nothing unlocking are left out.

MCP tool: `solana_unlocks_get_unlock_calendar`

Price: $0.002 per call (x402, USDC)

| Param | Required | Description | Example |
|---|---|---|---|
| from | no | First date, YYYY-MM-DD (default today) | 2026-12-01 |
| to | no | Last date, YYYY-MM-DD (default from + 89 days) | 2027-05-31 |
| group | no | day, week or month (default day) | month |

### GET /v1/solana-unlocks/unlocks

List 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.

MCP tool: `solana_unlocks_list_unlocks`

Price: $0.002 per call (x402, USDC)

| Param | Required | Description | Example |
|---|---|---|---|
| from | no | First date, YYYY-MM-DD (default today) | 2026-12-01 |
| to | no | Last date, YYYY-MM-DD (default from + 29 days) | 2026-12-31 |
| min_sol | no | Only unlocks of at least this many SOL | 10000 |
| withdraw_authority | no | Only stake accounts with this withdraw authority (base58) |  |
| custodian | no | Only lockups with this custodian (base58) |  |
| limit | no | Rows to return, 1 to 200 (default 50) | 20 |

## Attribution

Computed from Solana mainnet-beta stake accounts (Stake program, lockup.unix_timestamp in the future), refreshed hourly; meta.refreshed_at gives the time of the last refresh. Licence: https://solana.com/docs/rpc/http/getprogramaccounts
