Governance
On-chain governance proposals, voting results, stage history, and token governance configuration.
List Proposals
GET
/v1/governance?request=proposalsPaginated list of governance proposals with current voting stage. Supports multi-symbol filtering.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | `proposals` or `list` |
| limit | int | optional | 20 | Number of results (1–100) |
| offset | int | optional | 0 | Pagination offset |
| symbol | string | optional | — | Filter by token contract ID(s), comma-separated |
| status | string | optional | — | Filter: passed, failed, active, pending, fast_passed, cancelled |
| sort | string | optional | created_at | Sort: created_at, title, status, matures_at, votes, percentage |
| order | string | optional | desc | Sort direction: asc or desc |
🪙 Usage & Credits
This endpoint consumes 25 credits per request against your active API tier.
Response
json
{
"found": "integer",
"proposals": [
{
"hash": "string",
"stageNumber": "integer",
"lastStage": "boolean *",
"symbol": "string",
"creator": "string",
"title": "string",
"synopsis": "string",
"body": "string",
"options": [
{
"name": "string",
"curEquiv": "float",
"percentage": "float",
"votes": "object",
"transactions *": [
{
"type": "string",
"hash": "string"
}
]
}
],
"resultUpdated": "integer",
"result": "string",
"createdAt": "integer",
"validFrom": "integer",
"maturesAt": "integer"
}
]
}Proposal Details
GET
/v1/governance?request=detailsFull proposal detail with all voting stages and projected future stages. Performs live validator sync for active proposals.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | `details` or `proposal` |
| hash | string | REQUIRED | — | Proposal hash |
🪙 Usage & Credits
This endpoint consumes 100 credits per request against your active API tier.
Response
json
{
"hash": "string",
"symbol": "string",
"creator": "string",
"title": "string",
"synopsis": "string",
"body": "string",
"options": [ "string" ],
"createdAt": "integer",
"stages": [
{
"stageNumber": "integer",
"lastStage": "boolean",
"options": [
{
"name": "string",
"curEquiv": "float",
"percentage": "float",
"votes": "object",
"transactions *": [
{
"type": "string",
"hash": "string"
}
]
}
],
"resultUpdated": "integer",
"result": "string",
"validFrom": "integer",
"maturesAt": "integer"
}
]
}Errors
| Status | Condition |
|---|---|
| 400 | Missing hash/proposalHash parameter |
| 404 | Proposal not found |
Governance Config
GET
/v1/governance?request=configGovernance configuration for a token: type, stages, cycle timing, quorum.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| request | string | REQUIRED | — | Must be `config` |
| symbol | string | REQUIRED | — | Token contract ID |
🪙 Usage & Credits
This endpoint consumes 25 credits per request against your active API tier.
Response
json
{
"type": "string",
"activeProposals": "integer",
"totalProposals": "integer",
"threshold": "integer",
"quorum": "integer",
"fastQuorum": "integer *",
"durationDays": "integer *",
"durationMonths": "integer *",
"startCycleUnix": "integer *",
"endCycleUnix": "integer *",
"numberStages": "integer *",
"currentStageNumber": "integer *",
"stages *": [
{
"stageNumber": "integer",
"isBreak": "boolean",
"period": "string",
"length": "integer",
"maxAllowed": "integer *",
"startsAt": "integer *",
"endsAt": "integer *"
}
],
"approved": "integer",
"denied": "integer",
"firstTimeUnix": "integer",
"optionProposalsAlwaysWinner": "boolean *"
}