Proposals list

Get a list of proposals

Query Parameters

proposal string
proposer string

Responses

• 200
• default

---

A successful response.

application/json

Schema

Example (from schema)

---

Schema

proposals object[]
errorDetails string
id string
partyId string
rationale object
Rationale behind a proposal.
description string
title string
reason List of possible errors that can cause a proposal to be in state rejected or failed
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]
reference string
requiredLiquidityProviderMajority string
requiredLiquidityProviderParticipation string
requiredMajority string
requiredParticipation string
state Proposal state transition: Open -> - Passed -> Enacted. - Passed -> Failed. - Declined Rejected Proposal can enter Failed state from any other state
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.
closingTimestamp int64
enactmentTimestamp int64
newAsset object
Proposal change for creating new assets on Vega.
changes object
Configuration of the new asset.
builtinAsset object
Vega built-in asset.
maxFaucetAmountMint string
decimals uint64
erc20 object
Ethereum ERC20 asset.
contractAddress string
lifetimeLimit string
withdrawThreshold string
name string
quantum string
symbol string
newFreeform object
newMarket object
Proposal change for creating new market on Vega.
changes object
Configuration of the new market.
decimalPlaces uint64
instrument object
New market instrument configuration.
code string
future object
Future.
dataSourceSpecBinding object
Binding between the data source spec and the settlement data.
settlementDataProperty string
tradingTerminationProperty string
dataSourceSpecForSettlementData object
DataSourceDefinition represents the top level object that deals with data sources. DataSourceDefinition can be external or internal, with whatever number of data sources are defined for each type in the child objects below.
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
key object
Data source's data property key targeted by the filter.
name string
numberDecimalPlaces uint64
type string
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
address string
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.
key string
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
dataSourceSpecForTradingTermination object
DataSourceDefinition represents the top level object that deals with data sources. DataSourceDefinition can be external or internal, with whatever number of data sources are defined for each type in the child objects below.
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
key object
Data source's data property key targeted by the filter.
name string
numberDecimalPlaces uint64
type string
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
address string
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.
key string
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
quoteName string
settlementAsset string
name string
linearSlippageFactor string
liquidityMonitoringParameters object
Liquidity monitoring parameters.
auctionExtension int64
targetStakeParameters object
Specifies parameters related to target stake calculation.
scalingFactor double
timeWindow int64
triggeringRatio string
logNormal object
Log normal risk model parameters, valid only if MODEL_LOG_NORMAL is selected.
params object
Risk model parameters for log normal.
mu double
r double
sigma double
riskAversionParameter double
tau double
lpPriceRange string
metadata string[]
positionDecimalPlaces int64
priceMonitoringParameters object
Price monitoring parameters.
triggers object[]
auctionExtension int64
horizon int64
probability string
quadraticSlippageFactor string
simple object
Simple risk model parameters, valid only if MODEL_SIMPLE is selected.
factorLong double
factorShort double
maxMoveUp double
minMoveDown double
probabilityOfTrading double
updateAsset object
Proposal change for updating an asset.
assetId string
changes object
Changes to apply on an existing asset.
erc20 object
Ethereum ERC20 asset update.
lifetimeLimit string
withdrawThreshold string
quantum string
updateMarket object
Proposal change for modifying an existing market on Vega.
changes object
Updated configuration of the market.
instrument object
Updated market instrument configuration.
code string
future object
Future.
dataSourceSpecBinding object
The binding between the data source spec and the settlement data.
settlementDataProperty string
tradingTerminationProperty string
dataSourceSpecForSettlementData object
DataSourceDefinition represents the top level object that deals with data sources. DataSourceDefinition can be external or internal, with whatever number of data sources are defined for each type in the child objects below.
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
key object
Data source's data property key targeted by the filter.
name string
numberDecimalPlaces uint64
type string
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
address string
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.
key string
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
dataSourceSpecForTradingTermination object
DataSourceDefinition represents the top level object that deals with data sources. DataSourceDefinition can be external or internal, with whatever number of data sources are defined for each type in the child objects below.
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
key object
Data source's data property key targeted by the filter.
name string
numberDecimalPlaces uint64
type string
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
address string
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.
key string
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.
operator string
Possible values: [OPERATOR_UNSPECIFIED, OPERATOR_EQUALS, OPERATOR_GREATER_THAN, OPERATOR_GREATER_THAN_OR_EQUAL, OPERATOR_LESS_THAN, OPERATOR_LESS_THAN_OR_EQUAL]
value string
quoteName string
linearSlippageFactor string
liquidityMonitoringParameters object
Liquidity monitoring parameters.
auctionExtension int64
targetStakeParameters object
Specifies parameters related to target stake calculation.
scalingFactor double
timeWindow int64
triggeringRatio string
logNormal object
Log normal risk model parameters, valid only if MODEL_LOG_NORMAL is selected.
params object
Risk model parameters for log normal.
mu double
r double
sigma double
riskAversionParameter double
tau double
lpPriceRange string
metadata string[]
priceMonitoringParameters object
Price monitoring parameters.
triggers object[]
auctionExtension int64
horizon int64
probability string
quadraticSlippageFactor string
simple object
Simple risk model parameters, valid only if MODEL_SIMPLE is selected.
factorLong double
factorShort double
maxMoveUp double
minMoveDown double
probabilityOfTrading double
marketId string
updateNetworkParameter object
Proposal change for updating Vega network parameters.
changes object
The network parameter to update.
key string
value string
validationTimestamp int64
timestamp int64

{
  "proposals": [
    {
      "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"
    }
  ]
}

An unexpected error response.

application/json

Schema

Example (from schema)

---

Schema

code int32
details object[]
@type string
message string

{
  "code": 0,
  "details": [
    {
      "@type": "string"
    }
  ],
  "message": "string"
}

GET /proposals

Request

Base URL

https://n06.testnet.vega.xyz

proposal — query

proposer — query

curl / cURL

curl -L -X GET 'https://n06.testnet.vega.xyz/proposals' \
-H 'Accept: application/json'

python / requests

curl -L -X GET 'https://n06.testnet.vega.xyz/proposals' \
-H 'Accept: application/json'

go / native

curl -L -X GET 'https://n06.testnet.vega.xyz/proposals' \
-H 'Accept: application/json'

nodejs / axios

curl -L -X GET 'https://n06.testnet.vega.xyz/proposals' \
-H 'Accept: application/json'