Voting Endpoints

Cast, cancel, and withdraw governance votes, and settle a closed proposal. Requires the governance:vote scope.

Scope	governance:vote
Rate limit	60 / minute
Requires	tradingEnabled: true on GET /partner/v1/me

Every endpoint on this page takes priorityFeeLamports with a minimum of 1000 and tipLamports with a minimum of 1000000, and returns the standard governance write response.

POST /partner/v1/governance/votes

Casts a vote. The voted tokens are locked until the user withdraws them after the proposal closes.

Field	Type	Required	Constraint
proposal	string	Yes	Base58 proposal address
side	string	Yes	"yes" or "no"
amount	string	Yes	Integer string, greater than 0
priorityFeeLamports	string	Yes	Minimum 1000
tipLamports	string	Yes	Minimum 1000000

cURL

curl -X POST 'https://api.tren.ch/partner/v1/governance/votes' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "proposal": "…",
    "side": "yes",
    "amount": "1000000",
    "priorityFeeLamports": "20000",
    "tipLamports": "1000000"
  }'

Locked tokens cannot be traded until they are withdrawn, and users who are unaware of this tend to read it as missing funds. We recommend making the lock explicit in your UI.

A second vote on the same proposal fails with already_voted. To change a vote, cancel the existing one first.

POST /partner/v1/governance/votes/cancel

Retracts an active vote while voting is still open.

Field	Type	Required
proposal	string	Yes
priorityFeeLamports	string	Yes
tipLamports	string	Yes

POST /partner/v1/governance/votes/withdraw

Reclaims tokens locked by a vote, once the proposal has closed.

Field	Type	Required	Notes
proposal	string	Yes
voter	string	No	Defaults to the connected user’s wallet
priorityFeeLamports	string	Yes
tipLamports	string	Yes

The voter field exists so that anyone can crank a withdrawal on another wallet’s behalf. Tokens always return to the voter rather than to the caller, and for normal use the field can be left unset.

POST /partner/v1/governance/proposals/settle

Settles a proposal whose voting window has closed, computing the outcome and applying the action if it passed. The operation is permissionless, so anyone can call it, and someone must before the result takes effect.

Field	Type	Required
proposal	string	Yes
priorityFeeLamports	string	Yes
tipLamports	string	Yes

Settling before votingEndsAtUnix fails with proposal_still_open, and settling twice fails with proposal_already_settled.

Response

{
  "signature": "…",
  "status": "processed",
  "mint": "…",
  "governance": "…",
  "proposal": "…"
}

A status of processed is weaker than confirmed, meaning the transaction was included in a block but is not yet rooted. Confirm the signature against Solana through your own RPC before showing the user a settled result.

Errors

Status	Error	Cause
400	invalid_input	Body failed schema validation
403	insufficient_scope	Token lacks governance:vote
403	delegation_missing	User has not enabled 1-click trading
404	governance_not_found	Token has no governance
422	already_voted	User already has an active vote on this proposal
422	invalid_vote_amount	Below minLockAmount, or exceeds balance
422	missing_vote_token_account	User holds none of this token
422	proposal_closed	Voting has ended
422	proposal_still_open	Cannot settle yet
422	proposal_already_settled	Already settled
422	proposal_not_settled	Withdrawal requires settlement first
422	vote_not_active	The vote was cancelled
422	vote_already_withdrawn	Tokens already reclaimed
422	vote_receipt_not_found	No vote from this wallet on this proposal