Voting Endpoints


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 -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"
  }'

const res = await fetch("https://api.tren.ch/partner/v1/governance/votes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    proposal,
    side: "yes",
    amount: "1000000",
    priorityFeeLamports: "20000",
    tipLamports: "1000000",
  }),
});

import requests

res = requests.post(
  "https://api.tren.ch/partner/v1/governance/votes",
  headers={"Authorization": f"Bearer {access_token}"},
  json={
    "proposal": 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

Overview

OAuth

Trading

Governance

Voting Endpoints

POST /partner/v1/governance/votes

POST /partner/v1/governance/votes/cancel

POST /partner/v1/governance/votes/withdraw

POST /partner/v1/governance/proposals/settle

Response

Errors

​POST /partner/v1/governance/votes

​POST /partner/v1/governance/votes/cancel

​POST /partner/v1/governance/votes/withdraw

​POST /partner/v1/governance/proposals/settle

​Response

​Errors

POST /partner/v1/governance/votes

POST /partner/v1/governance/votes/cancel

POST /partner/v1/governance/votes/withdraw

POST /partner/v1/governance/proposals/settle

Response

Errors