Skip to main content
POST
Create Vesting Grant
For the complete documentation index, see llms.txt. Creates a vesting grant for a customer. Tokens are released gradually: a percentage unlocks at the cliff, and the rest unlocks linearly over the remaining vesting period. Each customer can have at most one active grant at a time.
Treat this as a transaction. If you don’t get a 200 OK, check /vesting-info before retrying. A successful retry over an existing grant returns 409.

Request Body

string
required
Your unique identifier for this customer
number
required
Total tokens to vest. Decimals allowed.
string
required
Total vesting period in seconds
string
required
Cliff period in seconds. No tokens vest before this point.
number
required
Percent of total released at the cliff (25 = 25%). Decimals allowed.

Response

string
Reference identifier for the grant