> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Vesting Schedule > Daily cumulative unlock state: how much has vested, how much remains, and what share of the allocation is complete. ## OpenAPI ````yaml api-reference/token-unlocks/openapi.json GET /token-unlocks/v1/assets/{assetId}/vesting-schedule openapi: 3.0.0 info: title: Blockworks Token Unlocks API description: OpenAPI specification for the Blockworks Token Unlocks API. version: 1.0.0 servers: - url: https://api.blockworks.com description: Blockworks API security: - apiKey: [] tags: - name: Assets description: Coverage, unlock events, and the two timeseries views. - name: Allocations description: Who holds what, and how much of it has unlocked. paths: /token-unlocks/v1/assets/{assetId}/vesting-schedule: get: tags: - Assets summary: Get vesting schedule description: >- Daily cumulative vesting state: how much has unlocked, how much is left, and what share of the allocation is complete, per day and per recipient. This is the stock series, the counterpart to the per-interval flow from the unlocks endpoint. operationId: getVestingScheduleTimeseries parameters: - name: assetId in: path description: Asset to look up. Accepts a slug (`solana`) or the asset UUID. schema: type: string example: solana required: true - name: startTime in: query description: RFC 3339 timestamp for the start of the window. schema: type: string format: date-time example: '2025-01-01T00:00:00Z' - name: endTime in: query description: >- RFC 3339 timestamp for the end of the window. Future dates are valid: the schedule is projected forward. schema: type: string format: date-time example: '2025-02-01T00:00:00Z' responses: '200': description: Daily cumulative vesting state for the asset. content: application/json: schema: type: object properties: error: type: string nullable: true description: '`null` on success.' data: $ref: '#/components/schemas/VestingSchedule' required: - data example: error: null data: asset: id: b3d5d66c-26a2-404c-9325-91dc714a722b name: Solana slug: solana symbol: SOL genesisDate: '2020-04-07T00:00:00Z' projectedEndDate: '2029-03-01T00:00:00Z' startTime: '2020-04-07T00:00:00Z' endTime: '2021-03-07T00:00:00Z' totalDailySnapshots: - timestamp: '2020-04-07T00:00:00Z' cumulativeUnlockedUSD: 1553853121.763593 cumulativeUnlockedNative: 8225000 unlocksRemainingUSD: 88433606755.39777 unlocksRemainingNative: 468105000 percentOfUnlocksCompleted: 0.017267440639892512 - timestamp: '2020-04-08T00:00:00Z' cumulativeUnlockedUSD: 1553853121.763593 cumulativeUnlockedNative: 8225000 unlocksRemainingUSD: 88433606755.39777 unlocksRemainingNative: 468105000 percentOfUnlocksCompleted: 0.017267440639892512 - timestamp: '2020-04-09T00:00:00Z' cumulativeUnlockedUSD: 1553853121.763593 cumulativeUnlockedNative: 8225000 unlocksRemainingUSD: 88433606755.39777 unlocksRemainingNative: 468105000 percentOfUnlocksCompleted: 0.017267440639892512 allocations: - allocationRecipient: Validator Sale dailySnapshots: - timestamp: '2020-04-07T00:00:00Z' cumulativeUnlockedUSD: 0 cumulativeUnlockedNative: 0 unlocksRemainingUSD: 4892984298.319399 unlocksRemainingNative: 25900000 percentOfUnlocksCompleted: 0 - timestamp: '2020-04-08T00:00:00Z' cumulativeUnlockedUSD: 0 cumulativeUnlockedNative: 0 unlocksRemainingUSD: 4892984298.319399 unlocksRemainingNative: 25900000 percentOfUnlocksCompleted: 0 - timestamp: '2020-04-09T00:00:00Z' cumulativeUnlockedUSD: 0 cumulativeUnlockedNative: 0 unlocksRemainingUSD: 4892984298.319399 unlocksRemainingNative: 25900000 percentOfUnlocksCompleted: 0 - allocationRecipient: FTX Estate dailySnapshots: - timestamp: '2020-04-07T00:00:00Z' cumulativeUnlockedUSD: 0 cumulativeUnlockedNative: 0 unlocksRemainingUSD: 2234903638.962104 unlocksRemainingNative: 11830000 percentOfUnlocksCompleted: 0 - timestamp: '2020-04-08T00:00:00Z' cumulativeUnlockedUSD: 0 cumulativeUnlockedNative: 0 unlocksRemainingUSD: 2234903638.962104 unlocksRemainingNative: 11830000 percentOfUnlocksCompleted: 0 - timestamp: '2020-04-09T00:00:00Z' cumulativeUnlockedUSD: 0 cumulativeUnlockedNative: 0 unlocksRemainingUSD: 2234903638.962104 unlocksRemainingNative: 11830000 percentOfUnlocksCompleted: 0 '400': description: >- Malformed request, for example an `interval` outside the allowed set or an unparseable timestamp. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Missing or invalid API key, or a key without token unlock access. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Server error. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: VestingSchedule: type: object description: >- Daily cumulative vesting state for one asset, in total and per recipient. properties: asset: $ref: '#/components/schemas/AssetBasic' genesisDate: type: string format: date-time description: Date the token's vesting timeline begins. projectedEndDate: type: string format: date-time description: Date the last scheduled unlock is projected to land. startTime: type: string format: date-time description: Start of the returned window. endTime: type: string format: date-time description: End of the returned window. totalDailySnapshots: type: array description: Cumulative state across every recipient, one entry per day. items: $ref: '#/components/schemas/VestingScheduleSnapshot' allocations: type: array description: The same series split by recipient. items: $ref: '#/components/schemas/AllocationVestingScheduleTranche' required: - asset - startTime - endTime - totalDailySnapshots - allocations Error: type: object description: Failure envelope. `error` carries the message and `data` is `null`. properties: error: type: string description: Error message. example: invalid auth mechanism data: nullable: true description: Always `null` on failure. required: - data AssetBasic: type: object description: >- The asset an unlock payload belongs to. The `id` is the same asset UUID the Data API and Monitoring API use, so unlock data joins to the rest of the platform without a mapping table. properties: id: type: string format: uuid description: Asset UUID, shared across Blockworks APIs. example: b3d5d66c-26a2-404c-9325-91dc714a722b name: type: string description: Display name. example: Solana slug: type: string description: URL-safe identifier. example: solana symbol: type: string description: Ticker symbol. example: SOL required: - id - name - slug - symbol VestingScheduleSnapshot: type: object description: Cumulative unlock state on a single day. Stock, not flow. properties: timestamp: type: string format: date-time description: The day this snapshot describes. cumulativeUnlockedUSD: type: number format: double description: Value unlocked from genesis through this day, in USD. cumulativeUnlockedNative: type: number format: double description: Tokens unlocked from genesis through this day, in native units. unlocksRemainingUSD: type: number format: double description: Value still locked as of this day, in USD. unlocksRemainingNative: type: number format: double description: Tokens still locked as of this day, in native units. percentOfUnlocksCompleted: type: number format: double description: >- Share of the allocation unlocked as of this day, as a decimal fraction from 0 to 1. required: - timestamp - cumulativeUnlockedNative - unlocksRemainingNative - percentOfUnlocksCompleted AllocationVestingScheduleTranche: type: object description: Daily cumulative vesting state for one recipient. properties: allocationRecipient: type: string description: Recipient bucket. example: Validator Sale dailySnapshots: type: array description: One entry per day in the window. items: $ref: '#/components/schemas/VestingScheduleSnapshot' required: - allocationRecipient - dailySnapshots securitySchemes: apiKey: type: apiKey in: header name: X-Blockworks-API-Key ````