List governance data
Get a list of proposals
Query Parameters
- STATE_UNSPECIFIED: Default value, always invalid
- STATE_FAILED: Proposal enactment has failed - even though proposal has passed, its execution could not be performed
- STATE_OPEN: Proposal is open for voting
- STATE_PASSED: Proposal has gained enough support to be executed
- STATE_REJECTED: Proposal wasn't accepted i.e. proposal terms failed validation due to wrong configuration or failed to meet network requirements.
- STATE_DECLINED: Proposal didn't get enough votes, e.g. either failed to gain required participation or majority level.
- STATE_ENACTED: Proposal enacted
- STATE_WAITING_FOR_NODE_VOTE: Waiting for node validation of the proposal
- TYPE_ALL: List all proposals
- TYPE_NEW_MARKET: List new market proposals
- TYPE_UPDATE_MARKET: List update market proposals
- TYPE_NETWORK_PARAMETERS: List change Vega network parameter proposals
- TYPE_NEW_ASSET: New asset proposals
- TYPE_NEW_FREE_FORM: Proposals for creating a new free form proposal
- TYPE_UPDATE_ASSET: Update asset proposals
Possible values: [STATE_UNSPECIFIED
, STATE_FAILED
, STATE_OPEN
, STATE_PASSED
, STATE_REJECTED
, STATE_DECLINED
, STATE_ENACTED
, STATE_WAITING_FOR_NODE_VOTE
]
Default value: STATE_UNSPECIFIED
Proposal state to list governance data for, if provided.
Possible values: [TYPE_UNSPECIFIED
, TYPE_ALL
, TYPE_NEW_MARKET
, TYPE_UPDATE_MARKET
, TYPE_NETWORK_PARAMETERS
, TYPE_NEW_ASSET
, TYPE_NEW_FREE_FORM
, TYPE_UPDATE_ASSET
]
Default value: TYPE_UNSPECIFIED
Proposal type to list governance data for, if provided.
Proposer party ID to list governance data for, if provided.
Proposal reference to list governance data for, if provided.
Number of records to be returned that sort greater than row identified by cursor supplied in 'after'.
If paging forwards, the cursor string for the last row of the previous page.
Number of records to be returned that sort less than row identified by cursor supplied in 'before'.
If paging forwards, the cursor string for the first row of the previous page.
Newest records first, older records last, default is true.
- 200
- 500
- default
A successful response.
Schema
connection object
{
"connection": {
"edges": [
{
"cursor": "string",
"node": {
"no": [
{
"partyId": "string",
"proposalId": "string",
"timestamp": "string",
"totalEquityLikeShareWeight": "string",
"totalGovernanceTokenBalance": "string",
"totalGovernanceTokenWeight": "string",
"value": "VALUE_UNSPECIFIED"
}
],
"noParty": {},
"proposal": {
"errorDetails": "string",
"id": "string",
"partyId": "string",
"rationale": {
"description": "string",
"title": "string"
},
"reason": "PROPOSAL_ERROR_UNSPECIFIED",
"reference": "string",
"requiredLiquidityProviderMajority": "string",
"requiredLiquidityProviderParticipation": "string",
"requiredMajority": "string",
"requiredParticipation": "string",
"state": "STATE_UNSPECIFIED",
"terms": {
"closingTimestamp": "string",
"enactmentTimestamp": "string",
"newAsset": {
"changes": {
"builtinAsset": {
"maxFaucetAmountMint": "string"
},
"decimals": "string",
"erc20": {
"contractAddress": "string",
"lifetimeLimit": "string",
"withdrawThreshold": "string"
},
"name": "string",
"quantum": "string",
"symbol": "string"
}
},
"newFreeform": {},
"newMarket": {
"changes": {
"decimalPlaces": "string",
"instrument": {
"code": "string",
"future": {
"dataSourceSpecBinding": {
"settlementDataProperty": "string",
"tradingTerminationProperty": "string"
},
"dataSourceSpecForSettlementData": {
"external": {
"oracle": {
"filters": [
{
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
],
"key": {
"name": "string",
"numberDecimalPlaces": "string",
"type": "TYPE_UNSPECIFIED"
}
}
],
"signers": [
{
"ethAddress": {
"address": "string"
},
"pubKey": {
"key": "string"
}
}
]
}
},
"internal": {
"time": {
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
]
}
}
},
"dataSourceSpecForTradingTermination": {
"external": {
"oracle": {
"filters": [
{
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
],
"key": {
"name": "string",
"numberDecimalPlaces": "string",
"type": "TYPE_UNSPECIFIED"
}
}
],
"signers": [
{
"ethAddress": {
"address": "string"
},
"pubKey": {
"key": "string"
}
}
]
}
},
"internal": {
"time": {
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
]
}
}
},
"quoteName": "string",
"settlementAsset": "string"
},
"name": "string"
},
"linearSlippageFactor": "string",
"liquidityMonitoringParameters": {
"auctionExtension": "string",
"targetStakeParameters": {
"scalingFactor": 0,
"timeWindow": "string"
},
"triggeringRatio": "string"
},
"logNormal": {
"params": {
"mu": 0,
"r": 0,
"sigma": 0
},
"riskAversionParameter": 0,
"tau": 0
},
"lpPriceRange": "string",
"metadata": [
"string"
],
"positionDecimalPlaces": "string",
"priceMonitoringParameters": {
"triggers": [
{
"auctionExtension": "string",
"horizon": "string",
"probability": "string"
}
]
},
"quadraticSlippageFactor": "string",
"simple": {
"factorLong": 0,
"factorShort": 0,
"maxMoveUp": 0,
"minMoveDown": 0,
"probabilityOfTrading": 0
}
}
},
"updateAsset": {
"assetId": "string",
"changes": {
"erc20": {
"lifetimeLimit": "string",
"withdrawThreshold": "string"
},
"quantum": "string"
}
},
"updateMarket": {
"changes": {
"instrument": {
"code": "string",
"future": {
"dataSourceSpecBinding": {
"settlementDataProperty": "string",
"tradingTerminationProperty": "string"
},
"dataSourceSpecForSettlementData": {
"external": {
"oracle": {
"filters": [
{
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
],
"key": {
"name": "string",
"numberDecimalPlaces": "string",
"type": "TYPE_UNSPECIFIED"
}
}
],
"signers": [
{
"ethAddress": {
"address": "string"
},
"pubKey": {
"key": "string"
}
}
]
}
},
"internal": {
"time": {
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
]
}
}
},
"dataSourceSpecForTradingTermination": {
"external": {
"oracle": {
"filters": [
{
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
],
"key": {
"name": "string",
"numberDecimalPlaces": "string",
"type": "TYPE_UNSPECIFIED"
}
}
],
"signers": [
{
"ethAddress": {
"address": "string"
},
"pubKey": {
"key": "string"
}
}
]
}
},
"internal": {
"time": {
"conditions": [
{
"operator": "OPERATOR_UNSPECIFIED",
"value": "string"
}
]
}
}
},
"quoteName": "string"
}
},
"linearSlippageFactor": "string",
"liquidityMonitoringParameters": {
"auctionExtension": "string",
"targetStakeParameters": {
"scalingFactor": 0,
"timeWindow": "string"
},
"triggeringRatio": "string"
},
"logNormal": {
"params": {
"mu": 0,
"r": 0,
"sigma": 0
},
"riskAversionParameter": 0,
"tau": 0
},
"lpPriceRange": "string",
"metadata": [
"string"
],
"priceMonitoringParameters": {
"triggers": [
{
"auctionExtension": "string",
"horizon": "string",
"probability": "string"
}
]
},
"quadraticSlippageFactor": "string",
"simple": {
"factorLong": 0,
"factorShort": 0,
"maxMoveUp": 0,
"minMoveDown": 0,
"probabilityOfTrading": 0
}
},
"marketId": "string"
},
"updateNetworkParameter": {
"changes": {
"key": "string",
"value": "string"
}
},
"validationTimestamp": "string"
},
"timestamp": "string"
},
"yes": [
{
"partyId": "string",
"proposalId": "string",
"timestamp": "string",
"totalEquityLikeShareWeight": "string",
"totalGovernanceTokenBalance": "string",
"totalGovernanceTokenWeight": "string",
"value": "VALUE_UNSPECIFIED"
}
],
"yesParty": {}
}
}
],
"pageInfo": {
"endCursor": "string",
"hasNextPage": true,
"hasPreviousPage": true,
"startCursor": "string"
}
}
}
An internal server error
Schema
details object[]
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
An unexpected error response.
Schema
details object[]
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
GET /api/v2/governances
Request
Request
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/governances' \
-H 'Accept: application/json'
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/governances' \
-H 'Accept: application/json'
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/governances' \
-H 'Accept: application/json'
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/governances' \
-H 'Accept: application/json'