Skip to main content
Version: mainnet (v0.71)

Observe governance​

Subscribe to a stream of governance proposals

Query Parameters
    partyId string

    Party ID to get the governance subscription for, if provided.

Responses

A successful response.(streaming responses)

Schema
    error object
    code int32
    details object[]
    @type string
    message string
    result object
    data object

    Governance data, i.e. proposal and votes for and against.

    no object[]

    All NO votes against the proposal above.

    partyId string
    proposalId string
    timestamp int64
    totalEquityLikeShareWeight string
    totalGovernanceTokenBalance string
    totalGovernanceTokenWeight string
    value Vote value

    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.

  • property name* object
    • proposal object

    Governance proposal that is being voted on.

    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

    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.

    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

    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.

    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

    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.

    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

    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.

    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
    yes object[]

    All YES votes in favour of the proposal above.

    partyId string
    proposalId string
    timestamp int64
    totalEquityLikeShareWeight string
    totalGovernanceTokenBalance string
    totalGovernanceTokenWeight string
    value Vote value

    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.

  • property name* object
Loading...