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
property name*objectproperty name*object
connection object
Page of governance data and corresponding page information.
edges object[]
Page of governance data and their corresponding cursors.
node object
Governance data content, i.e. proposal and votes for and against.
no object[]
All NO votes against the proposal above.
Possible values: [VALUE_UNSPECIFIED, VALUE_NO, VALUE_YES]
noParty object
All latest NO votes by party which is guaranteed to be unique, where key (string) is the party ID i.e. public key and value (Vote) is the vote cast by the given party.
proposal object
Governance proposal that is being voted on.
rationale object
Rationale behind a proposal.
Possible values: [PROPOSAL_ERROR_UNSPECIFIED, PROPOSAL_ERROR_CLOSE_TIME_TOO_SOON, PROPOSAL_ERROR_CLOSE_TIME_TOO_LATE, PROPOSAL_ERROR_ENACT_TIME_TOO_SOON, PROPOSAL_ERROR_ENACT_TIME_TOO_LATE, PROPOSAL_ERROR_INSUFFICIENT_TOKENS, PROPOSAL_ERROR_INVALID_INSTRUMENT_SECURITY, PROPOSAL_ERROR_NO_PRODUCT, PROPOSAL_ERROR_UNSUPPORTED_PRODUCT, PROPOSAL_ERROR_NO_TRADING_MODE, PROPOSAL_ERROR_UNSUPPORTED_TRADING_MODE, PROPOSAL_ERROR_NODE_VALIDATION_FAILED, PROPOSAL_ERROR_MISSING_BUILTIN_ASSET_FIELD, PROPOSAL_ERROR_MISSING_ERC20_CONTRACT_ADDRESS, PROPOSAL_ERROR_INVALID_ASSET, PROPOSAL_ERROR_INCOMPATIBLE_TIMESTAMPS, PROPOSAL_ERROR_NO_RISK_PARAMETERS, PROPOSAL_ERROR_NETWORK_PARAMETER_INVALID_KEY, PROPOSAL_ERROR_NETWORK_PARAMETER_INVALID_VALUE, PROPOSAL_ERROR_NETWORK_PARAMETER_VALIDATION_FAILED, PROPOSAL_ERROR_OPENING_AUCTION_DURATION_TOO_SMALL, PROPOSAL_ERROR_OPENING_AUCTION_DURATION_TOO_LARGE, PROPOSAL_ERROR_COULD_NOT_INSTANTIATE_MARKET, PROPOSAL_ERROR_INVALID_FUTURE_PRODUCT, PROPOSAL_ERROR_INVALID_RISK_PARAMETER, PROPOSAL_ERROR_MAJORITY_THRESHOLD_NOT_REACHED, PROPOSAL_ERROR_PARTICIPATION_THRESHOLD_NOT_REACHED, PROPOSAL_ERROR_INVALID_ASSET_DETAILS, PROPOSAL_ERROR_UNKNOWN_TYPE, PROPOSAL_ERROR_UNKNOWN_RISK_PARAMETER_TYPE, PROPOSAL_ERROR_INVALID_FREEFORM, PROPOSAL_ERROR_INSUFFICIENT_EQUITY_LIKE_SHARE, PROPOSAL_ERROR_INVALID_MARKET, PROPOSAL_ERROR_TOO_MANY_MARKET_DECIMAL_PLACES, PROPOSAL_ERROR_TOO_MANY_PRICE_MONITORING_TRIGGERS, PROPOSAL_ERROR_ERC20_ADDRESS_ALREADY_IN_USE, PROPOSAL_ERROR_LP_PRICE_RANGE_NONPOSITIVE, PROPOSAL_ERROR_LP_PRICE_RANGE_TOO_LARGE, PROPOSAL_ERROR_LINEAR_SLIPPAGE_FACTOR_OUT_OF_RANGE, PROPOSAL_ERROR_QUADRATIC_SLIPPAGE_FACTOR_OUT_OF_RANGE]
Possible values: [STATE_UNSPECIFIED, STATE_FAILED, STATE_OPEN, STATE_PASSED, STATE_REJECTED, STATE_DECLINED, STATE_ENACTED, STATE_WAITING_FOR_NODE_VOTE]
terms object
Proposal configuration and the actual change that is meant to be executed when proposal is enacted.
newAsset object
Proposal change for creating new assets on Vega.
changes object
Configuration of the new asset.
builtinAsset object
Vega built-in asset.
erc20 object
Ethereum ERC20 asset.
newMarket object
Proposal change for creating new market on Vega.
changes object
Configuration of the new market.
instrument object
New market instrument configuration.
future object
Future.
dataSourceSpecBinding object
Binding between the data source spec and the settlement data.
dataSourceSpecForSettlementData object
Data source spec describing the data source for settlement.
external object
DataSourceDefinitionExternal is the top level object used for all external data sources.
It contains one of any of the defined SourceType variants.
oracle object
All types of external data sources use the same configuration set for meeting requirements in order for the data to be useful for Vega - valid signatures and matching filters.
filters object[]
Filters describes which source data are considered of interest or not for the product (or the risk model).
conditions object[]
Conditions that should be matched by the data to be considered of interest.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
key object
Data source's data property key targeted by the filter.
Possible values: [TYPE_UNSPECIFIED, TYPE_EMPTY, TYPE_INTEGER, TYPE_STRING, TYPE_BOOLEAN, TYPE_DECIMAL, TYPE_TIMESTAMP]
signers object[]
Signers is the list of authorized signatures that signed the data for this source. All the signatures in the data source data should be contained in this external source. All the signatures in the data should be contained in this list.
ethAddress object
pubKey object
List of authorized public keys that signed the data for this source. All the public keys in the data should be contained in these public keys.
internal object
DataSourceDefinitionInternal is the top level object used for all internal data sources.
It contains one of any of the defined SourceType variants.
time object
DataSourceSpecConfigurationTime is the internal data source used for emitting timestamps.
conditions object[]
Conditions that the timestamps should meet in order to be considered.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
dataSourceSpecForTradingTermination object
The external data source spec describing the data source of trading termination.
external object
DataSourceDefinitionExternal is the top level object used for all external data sources.
It contains one of any of the defined SourceType variants.
oracle object
All types of external data sources use the same configuration set for meeting requirements in order for the data to be useful for Vega - valid signatures and matching filters.
filters object[]
Filters describes which source data are considered of interest or not for the product (or the risk model).
conditions object[]
Conditions that should be matched by the data to be considered of interest.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
key object
Data source's data property key targeted by the filter.
Possible values: [TYPE_UNSPECIFIED, TYPE_EMPTY, TYPE_INTEGER, TYPE_STRING, TYPE_BOOLEAN, TYPE_DECIMAL, TYPE_TIMESTAMP]
signers object[]
Signers is the list of authorized signatures that signed the data for this source. All the signatures in the data source data should be contained in this external source. All the signatures in the data should be contained in this list.
ethAddress object
pubKey object
List of authorized public keys that signed the data for this source. All the public keys in the data should be contained in these public keys.
internal object
DataSourceDefinitionInternal is the top level object used for all internal data sources.
It contains one of any of the defined SourceType variants.
time object
DataSourceSpecConfigurationTime is the internal data source used for emitting timestamps.
conditions object[]
Conditions that the timestamps should meet in order to be considered.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
liquidityMonitoringParameters object
Liquidity monitoring parameters.
targetStakeParameters object
Specifies parameters related to target stake calculation.
logNormal object
Log normal risk model parameters, valid only if MODEL_LOG_NORMAL is selected.
params object
Risk model parameters for log normal.
priceMonitoringParameters object
Price monitoring parameters.
triggers object[]
simple object
Simple risk model parameters, valid only if MODEL_SIMPLE is selected.
updateAsset object
Proposal change for updating an asset.
changes object
Changes to apply on an existing asset.
erc20 object
Ethereum ERC20 asset update.
updateMarket object
Proposal change for modifying an existing market on Vega.
changes object
Updated configuration of the market.
instrument object
Updated market instrument configuration.
future object
Future.
dataSourceSpecBinding object
The binding between the data source spec and the settlement data.
dataSourceSpecForSettlementData object
The data source spec describing the data of settlement data.
external object
DataSourceDefinitionExternal is the top level object used for all external data sources.
It contains one of any of the defined SourceType variants.
oracle object
All types of external data sources use the same configuration set for meeting requirements in order for the data to be useful for Vega - valid signatures and matching filters.
filters object[]
Filters describes which source data are considered of interest or not for the product (or the risk model).
conditions object[]
Conditions that should be matched by the data to be considered of interest.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
key object
Data source's data property key targeted by the filter.
Possible values: [TYPE_UNSPECIFIED, TYPE_EMPTY, TYPE_INTEGER, TYPE_STRING, TYPE_BOOLEAN, TYPE_DECIMAL, TYPE_TIMESTAMP]
signers object[]
Signers is the list of authorized signatures that signed the data for this source. All the signatures in the data source data should be contained in this external source. All the signatures in the data should be contained in this list.
ethAddress object
pubKey object
List of authorized public keys that signed the data for this source. All the public keys in the data should be contained in these public keys.
internal object
DataSourceDefinitionInternal is the top level object used for all internal data sources.
It contains one of any of the defined SourceType variants.
time object
DataSourceSpecConfigurationTime is the internal data source used for emitting timestamps.
conditions object[]
Conditions that the timestamps should meet in order to be considered.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
dataSourceSpecForTradingTermination object
The data source spec describing the data source for trading termination.
external object
DataSourceDefinitionExternal is the top level object used for all external data sources.
It contains one of any of the defined SourceType variants.
oracle object
All types of external data sources use the same configuration set for meeting requirements in order for the data to be useful for Vega - valid signatures and matching filters.
filters object[]
Filters describes which source data are considered of interest or not for the product (or the risk model).
conditions object[]
Conditions that should be matched by the data to be considered of interest.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
key object
Data source's data property key targeted by the filter.
Possible values: [TYPE_UNSPECIFIED, TYPE_EMPTY, TYPE_INTEGER, TYPE_STRING, TYPE_BOOLEAN, TYPE_DECIMAL, TYPE_TIMESTAMP]
signers object[]
Signers is the list of authorized signatures that signed the data for this source. All the signatures in the data source data should be contained in this external source. All the signatures in the data should be contained in this list.
ethAddress object
pubKey object
List of authorized public keys that signed the data for this source. All the public keys in the data should be contained in these public keys.
internal object
DataSourceDefinitionInternal is the top level object used for all internal data sources.
It contains one of any of the defined SourceType variants.
time object
DataSourceSpecConfigurationTime is the internal data source used for emitting timestamps.
conditions object[]
Conditions that the timestamps should meet in order to be considered.
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
liquidityMonitoringParameters object
Liquidity monitoring parameters.
targetStakeParameters object
Specifies parameters related to target stake calculation.
logNormal object
Log normal risk model parameters, valid only if MODEL_LOG_NORMAL is selected.
params object
Risk model parameters for log normal.
priceMonitoringParameters object
Price monitoring parameters.
triggers object[]
simple object
Simple risk model parameters, valid only if MODEL_SIMPLE is selected.
updateNetworkParameter object
Proposal change for updating Vega network parameters.
changes object
The network parameter to update.
yes object[]
All YES votes in favour of the proposal above.
Possible values: [VALUE_UNSPECIFIED, VALUE_NO, VALUE_YES]
yesParty object
All latest YES votes by party which is guaranteed to be unique, where key (string) is the party ID i.e. public key and value (Vote) is the vote cast by the given party.
pageInfo object
Page information that is used for fetching further pages.
{
"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"
}