Events

Vesting Events

GET

/api/v1/wallet/{address}/vesting/events

Vesting events where the wallet is the actor, the beneficiary or the creator, newest first, cursor paged (?cursor=blockNumber:logIndex). Every vesting contract by default (the deployment's only when vestingId is given). walletPending marks a row whose wallet is not resolved yet. Alias for your own wallet: GET /api/v1/vesting/events. The schedules themselves are on chain: VESTING.getVestingsByBeneficiary / getVestingsByCreator, then getVestingDetailsBatch and getClaimableAmount (the API no longer lists them; a token's locked supply is lockedSupply on GET /api/v1/tokens/{address}).

Auth: API Key (the /me alias: Session or API Key)

Query Parameters

Param	Type	Description
action	string	`created`, `updated`, `claimed`, `extended`, `beneficiary_changed`, `renounced`, `creator_transferred`, `loan_taken`, `loan_repaid`, or `loan_liquidated`
vestingId	number	Filter by vesting ID (unique per vesting contract and chain)
role	string	`actor`, `beneficiary`, `creator`, or `any` (default)
vestingContract	string	Vesting contract address (default: this deployment's)
page	number	Page number (default: 1)
limit	number	Items per page (default: 20, max: 100)

Response

{
  "data": [{
    "chainId": 4663,
    "vestingContract": "0x...",
    "wallet": "0x...",
    "action": "created",
    "vestingId": 1,
    "creator": "0x...",
    "beneficiary": "0x...",
    "main": "0x...",
    "token": "0x...",
    "amount": "5000000000000000000000",
    "usdE18": "5100000000000000000000",
    "usdSource": "fixed",
    "data": "{\"creator\":\"0x...\",\"beneficiary\":\"0x...\"}",
    "txHash": "0x...",
    "logIndex": 4,
    "blockNumber": 12345678,
    "timestamp": "2026-03-20T00:00:00.000Z"
  }],
  "pagination": { "limit": 20, "hasMore": false, "nextCursor": null }
}

usdE18 (+ usdSource) is the USD × 1e18 of amount at the block time, stamped at sync, on created (the tokens locked) and claimed (the tokens paid out); null on every other action or when the token had no price then.

Loan steps of a vesting also appear in /api/v1/loans/events with source=vesting.