Get transaction

Get a transaction from the Vega blockchain

Path Parameters

hash string required

Hash of the transaction

Responses

• 200
• default

---

A successful response.

application/json

Schema

Example (from schema)

---

Schema

transaction object
block uint64
code int64
command object
announceNode object
Command used by a node operator to announce its node as a pending validator.
avatarUrl string
chainPubKey string
country string
ethereumAddress string
ethereumSignature object
Signature from the validator made using the ethereum wallet.
algo string
value string
version int64
fromEpoch uint64
id string
infoUrl string
name string
submitterAddress string
vegaPubKey string
vegaPubKeyIndex int64
vegaSignature object
Signature from the validator made using the Vega wallet.
algo string
value string
version int64
batchMarketInstructions object
Command to submit a batch of order instructions to a market.
amendments object[]
List of order amendments to be processed sequentially.
expiresAt int64
marketId string
orderId string
peggedOffset string
peggedReference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
price string
sizeDelta int64
timeInForce Time In Force for an order
Possible values: [TIME_IN_FORCE_UNSPECIFIED, TIME_IN_FORCE_GTC, TIME_IN_FORCE_GTT, TIME_IN_FORCE_IOC, TIME_IN_FORCE_FOK, TIME_IN_FORCE_GFA, TIME_IN_FORCE_GFN]
cancellations object[]
List of order cancellations to be processed sequentially.
marketId string
orderId string
submissions object[]
List of order submissions to be processed sequentially.
expiresAt int64
marketId string
peggedOrder object
Used to specify the details for a pegged order.
offset string
reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
postOnly boolean
price string
reduceOnly boolean
reference string
side Side relates to the direction of an order, to Buy, or Sell
Possible values: [SIDE_UNSPECIFIED, SIDE_BUY, SIDE_SELL]
size uint64
timeInForce Time In Force for an order
Possible values: [TIME_IN_FORCE_UNSPECIFIED, TIME_IN_FORCE_GTC, TIME_IN_FORCE_GTT, TIME_IN_FORCE_IOC, TIME_IN_FORCE_FOK, TIME_IN_FORCE_GFA, TIME_IN_FORCE_GFN]
type Type values for an order
Possible values: [TYPE_UNSPECIFIED, TYPE_LIMIT, TYPE_MARKET, TYPE_NETWORK]
blockHeight uint64
cancelTransfer object
Command to request cancelling a recurring transfer.
transferId string
chainEvent object
Command used by a validator to submit an event forwarded to the Vega network to provide information on events happening on other networks, to be used by a foreign chain to recognise a decision taken by the Vega network.
builtin object
Built-in asset event.
deposit object
Built-in asset deposit.
amount string
partyId string
vegaAssetId string
withdrawal object
Built-in asset withdrawal.
amount string
partyId string
vegaAssetId string
erc20 object
Ethereum ERC20 event.
assetDelist object
De-list an ERC20 asset.
vegaAssetId string
assetLimitsUpdated object
Update an ERC20 asset.
lifetimeLimits string
sourceEthereumAddress string
vegaAssetId string
withdrawThreshold string
assetList object
List an ERC20 asset.
assetSource string
vegaAssetId string
block uint64
bridgeResumed boolean
bridgeStopped boolean
deposit object
Deposit ERC20 asset.
amount string
sourceEthereumAddress string
targetPartyId string
vegaAssetId string
index uint64
withdrawal object
Withdraw ERC20 asset.
referenceNonce string
targetEthereumAddress string
vegaAssetId string
erc20Multisig object
Ethereum ERC20 multisig event.
block uint64
index uint64
signerAdded object
blockTime int64
newSigner Ethereum address of the new signer
nonce Nonce created by the Vega network used for this new signer
signerRemoved object
blockTime int64
nonce Nonce created by the Vega network used for this old signer
oldSigner Ethereum address of the old signer
thresholdSet object
blockTime int64
newThreshold int64
nonce Nonce created by the Vega network
nonce uint64
stakingEvent object
Ethereum Staking event.
block uint64
index uint64
stakeDeposited object
amount string
blockTime int64
ethereumAddress Ethereum Address of the user depositing stake (hex encode with 0x prefix)
vegaPublicKey string
stakeRemoved object
amount string
blockTime int64
ethereumAddress string
vegaPublicKey string
totalSupply object
tokenAddress Address of the staking asset
totalSupply string
txId string
delegateSubmission object
Command to delegate tokens to a validator.
amount string
nodeId string
ethereumKeyRotateSubmission object
Command used by a validator to allow given validator to rotate their Ethereum keys.
currentAddress string
ethereumSignature object
Signature that can be verified using the new ethereum address.
algo string
value string
version int64
newAddress string
submitterAddress string
targetBlock uint64
issueSignatures object
Command used by a validator to submit signatures to a smart contract.
kind Kind of signature created by a node, for example, allow-listing a new asset, withdrawal etc
Possible values: [NODE_SIGNATURE_KIND_UNSPECIFIED, NODE_SIGNATURE_KIND_ASSET_NEW, NODE_SIGNATURE_KIND_ASSET_WITHDRAWAL, NODE_SIGNATURE_KIND_ERC20_MULTISIG_SIGNER_ADDED, NODE_SIGNATURE_KIND_ERC20_MULTISIG_SIGNER_REMOVED, NODE_SIGNATURE_KIND_ASSET_UPDATE]
submitter string
validatorNodeId string
keyRotateSubmission object
Command used by a validator to allow given validator to rotate their Vega keys.
currentPubKeyHash string
newPubKey string
newPubKeyIndex int64
targetBlock uint64
liquidityProvisionAmendment object
Command to request amending a liquidity commitment.
buys object[]
offset string
proportion int64
reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
commitmentAmount string
fee string
marketId string
reference string
sells object[]
offset string
proportion int64
reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
liquidityProvisionCancellation object
Command to request cancelling a liquidity commitment.
marketId string
liquidityProvisionSubmission object
Command to submit a liquidity commitment.
buys object[]
Set of liquidity buy orders to meet the liquidity provision obligation.
offset string
proportion int64
reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
commitmentAmount string
fee string
marketId string
reference string
sells object[]
Set of liquidity sell orders to meet the liquidity provision obligation.
offset string
proportion int64
reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
nodeSignature object
Command used by a validator to submit a signature, to be used by a foreign chain to recognise a decision taken by the Vega network.
id string
kind Kind of signature created by a node, for example, allow-listing a new asset, withdrawal etc
Possible values: [NODE_SIGNATURE_KIND_UNSPECIFIED, NODE_SIGNATURE_KIND_ASSET_NEW, NODE_SIGNATURE_KIND_ASSET_WITHDRAWAL, NODE_SIGNATURE_KIND_ERC20_MULTISIG_SIGNER_ADDED, NODE_SIGNATURE_KIND_ERC20_MULTISIG_SIGNER_REMOVED, NODE_SIGNATURE_KIND_ASSET_UPDATE]
sig byte
nodeVote object
Command used by a validator when a node votes for validating that a given resource exists or is valid, for example, an ERC20 deposit is valid and exists on ethereum.
reference string
type - TYPE_UNSPECIFIED: Represents an unspecified or missing value from the input - TYPE_STAKE_DEPOSITED: Node vote for a new stake deposit - TYPE_STAKE_REMOVED: Node vote for a new stake removed event - TYPE_FUNDS_DEPOSITED: Node vote for a new collateral deposit - TYPE_SIGNER_ADDED: Node vote for a new signer added to the erc20 bridge - TYPE_SIGNER_REMOVED: Node vote for a signer removed from the erc20 bridge - TYPE_BRIDGE_STOPPED: Node vote for a bridge stopped event - TYPE_BRIDGE_RESUMED: Node vote for a bridge resumed event - TYPE_ASSET_LISTED: Node vote for a newly listed asset - TYPE_LIMITS_UPDATED: Node vote for an asset limits update - TYPE_STAKE_TOTAL_SUPPLY: Node vote to share the total supply of the staking token - TYPE_SIGNER_THRESHOLD_SET: Node vote to update the threshold of the signer set for the multisig contract - TYPE_GOVERNANCE_VALIDATE_ASSET: Node vote to validate a new assert governance proposal
Possible values: [TYPE_UNSPECIFIED, TYPE_STAKE_DEPOSITED, TYPE_STAKE_REMOVED, TYPE_FUNDS_DEPOSITED, TYPE_SIGNER_ADDED, TYPE_SIGNER_REMOVED, TYPE_BRIDGE_STOPPED, TYPE_BRIDGE_RESUMED, TYPE_ASSET_LISTED, TYPE_LIMITS_UPDATED, TYPE_STAKE_TOTAL_SUPPLY, TYPE_SIGNER_THRESHOLD_SET, TYPE_GOVERNANCE_VALIDATE_ASSET]
nonce uint64
oracleDataSubmission object
Command to submit new oracle data from third party providers.
payload byte
source Supported oracle sources
Possible values: [ORACLE_SOURCE_UNSPECIFIED, ORACLE_SOURCE_OPEN_ORACLE, ORACLE_SOURCE_JSON]
orderAmendment object
Command to amend an order.
expiresAt int64
marketId string
orderId string
peggedOffset string
peggedReference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
price string
sizeDelta int64
timeInForce Time In Force for an order
Possible values: [TIME_IN_FORCE_UNSPECIFIED, TIME_IN_FORCE_GTC, TIME_IN_FORCE_GTT, TIME_IN_FORCE_IOC, TIME_IN_FORCE_FOK, TIME_IN_FORCE_GFA, TIME_IN_FORCE_GFN]
orderCancellation object
Command to cancel an order.
marketId string
orderId string
orderSubmission object
Command for submitting an order.
expiresAt int64
marketId string
peggedOrder object
Used to specify the details for a pegged order.
offset string
reference Pegged reference defines which price point a pegged order is linked to - meaning the price for a pegged order is calculated from the value of the reference price point
Possible values: [PEGGED_REFERENCE_UNSPECIFIED, PEGGED_REFERENCE_MID, PEGGED_REFERENCE_BEST_BID, PEGGED_REFERENCE_BEST_ASK]
postOnly boolean
price string
reduceOnly boolean
reference string
side Side relates to the direction of an order, to Buy, or Sell
Possible values: [SIDE_UNSPECIFIED, SIDE_BUY, SIDE_SELL]
size uint64
timeInForce Time In Force for an order
Possible values: [TIME_IN_FORCE_UNSPECIFIED, TIME_IN_FORCE_GTC, TIME_IN_FORCE_GTT, TIME_IN_FORCE_IOC, TIME_IN_FORCE_FOK, TIME_IN_FORCE_GFA, TIME_IN_FORCE_GFN]
type Type values for an order
Possible values: [TYPE_UNSPECIFIED, TYPE_LIMIT, TYPE_MARKET, TYPE_NETWORK]
proposalSubmission object
Command to submit a governance proposal.
rationale object
Rationale behind a proposal.
description string
title string
reference string
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
protocolUpgradeProposal object
Command used by a validator to propose a protocol upgrade.
upgradeBlockHeight uint64
vegaReleaseTag string
stateVariableProposal object
Command used by a validator to submit a floating point value.
proposal object
State value proposal details.
eventId string
kvb object[]
Key value tolerance triplets.
key string
tolerance string
value object
matrixVal object
value object[]
value string[]
scalarVal object
value string
vectorVal object
value string[]
stateVarId string
transfer object
Command to submit a transfer.
amount string
asset string
fromAccountType Various collateral/account types as used by Vega
Possible values: [ACCOUNT_TYPE_UNSPECIFIED, ACCOUNT_TYPE_INSURANCE, ACCOUNT_TYPE_SETTLEMENT, ACCOUNT_TYPE_MARGIN, ACCOUNT_TYPE_GENERAL, ACCOUNT_TYPE_FEES_INFRASTRUCTURE, ACCOUNT_TYPE_FEES_LIQUIDITY, ACCOUNT_TYPE_FEES_MAKER, ACCOUNT_TYPE_BOND, ACCOUNT_TYPE_EXTERNAL, ACCOUNT_TYPE_GLOBAL_INSURANCE, ACCOUNT_TYPE_GLOBAL_REWARD, ACCOUNT_TYPE_PENDING_TRANSFERS, ACCOUNT_TYPE_REWARD_MAKER_PAID_FEES, ACCOUNT_TYPE_REWARD_MAKER_RECEIVED_FEES, ACCOUNT_TYPE_REWARD_LP_RECEIVED_FEES, ACCOUNT_TYPE_REWARD_MARKET_PROPOSERS]
oneOff object
deliverOn int64
recurring object
dispatchStrategy object
Optional parameter defining how a transfer is dispatched.
assetForMetric string
markets string[]
metric - DISPATCH_METRIC_MAKER_FEES_PAID: Dispatch metric that is using the total maker fees paid in the market - DISPATCH_METRIC_MAKER_FEES_RECEIVED: Dispatch metric that is using the total maker fees received in the market - DISPATCH_METRIC_LP_FEES_RECEIVED: Dispatch metric that is using the total LP fees received in the market - DISPATCH_METRIC_MARKET_VALUE: Dispatch metric that is using total value of the market if above the required threshold and not paid given proposer bonus yet
Possible values: [DISPATCH_METRIC_UNSPECIFIED, DISPATCH_METRIC_MAKER_FEES_PAID, DISPATCH_METRIC_MAKER_FEES_RECEIVED, DISPATCH_METRIC_LP_FEES_RECEIVED, DISPATCH_METRIC_MARKET_VALUE]
endEpoch uint64
factor string
startEpoch uint64
reference string
to string
toAccountType Various collateral/account types as used by Vega
Possible values: [ACCOUNT_TYPE_UNSPECIFIED, ACCOUNT_TYPE_INSURANCE, ACCOUNT_TYPE_SETTLEMENT, ACCOUNT_TYPE_MARGIN, ACCOUNT_TYPE_GENERAL, ACCOUNT_TYPE_FEES_INFRASTRUCTURE, ACCOUNT_TYPE_FEES_LIQUIDITY, ACCOUNT_TYPE_FEES_MAKER, ACCOUNT_TYPE_BOND, ACCOUNT_TYPE_EXTERNAL, ACCOUNT_TYPE_GLOBAL_INSURANCE, ACCOUNT_TYPE_GLOBAL_REWARD, ACCOUNT_TYPE_PENDING_TRANSFERS, ACCOUNT_TYPE_REWARD_MAKER_PAID_FEES, ACCOUNT_TYPE_REWARD_MAKER_RECEIVED_FEES, ACCOUNT_TYPE_REWARD_LP_RECEIVED_FEES, ACCOUNT_TYPE_REWARD_MARKET_PROPOSERS]
undelegateSubmission object
Command to remove tokens delegated to a validator.
amount string
method string
Possible values: [METHOD_UNSPECIFIED, METHOD_NOW, METHOD_AT_END_OF_EPOCH]
nodeId string
validatorHeartbeat object
Command used by a validator to signal they are still online and validating blocks or ready to validate blocks when they are still a pending validator.
ethereumSignature object
Signature from the validator made using the ethereum wallet.
algo string
value string
version int64
message string
nodeId string
vegaSignature object
Signature from the validator made using the vega wallet.
algo string
value string
version int64
voteSubmission object
Command to submit a vote on a governance proposal.
proposalId string
value Vote value
Possible values: [VALUE_UNSPECIFIED, VALUE_NO, VALUE_YES]
withdrawSubmission object
Command to submit a withdrawal.
amount string
asset string
ext object
Foreign chain specifics.
erc20 object
ERC20 withdrawal details.
receiverAddress string
cursor Cursor for this transaction. This is used for paginating results
error Optional error happening when processing / checking the transaction This should be set if error code is not 0
hash Hash of the transaction
index int64
signature object
Signature to authenticate a transaction and to be verified by the Vega network.
algo string
value string
version int64
submitter Vega public key of the transaction's submitter
type Type of transaction

{
  "transaction": {
    "block": "string",
    "code": 0,
    "command": {
      "announceNode": {
        "avatarUrl": "string",
        "chainPubKey": "string",
        "country": "string",
        "ethereumAddress": "string",
        "ethereumSignature": {
          "algo": "string",
          "value": "string",
          "version": 0
        },
        "fromEpoch": "string",
        "id": "string",
        "infoUrl": "string",
        "name": "string",
        "submitterAddress": "string",
        "vegaPubKey": "string",
        "vegaPubKeyIndex": 0,
        "vegaSignature": {
          "algo": "string",
          "value": "string",
          "version": 0
        }
      },
      "batchMarketInstructions": {
        "amendments": [
          {
            "expiresAt": "string",
            "marketId": "string",
            "orderId": "string",
            "peggedOffset": "string",
            "peggedReference": "PEGGED_REFERENCE_UNSPECIFIED",
            "price": "string",
            "sizeDelta": "string",
            "timeInForce": "TIME_IN_FORCE_UNSPECIFIED"
          }
        ],
        "cancellations": [
          {
            "marketId": "string",
            "orderId": "string"
          }
        ],
        "submissions": [
          {
            "expiresAt": "string",
            "marketId": "string",
            "peggedOrder": {
              "offset": "string",
              "reference": "PEGGED_REFERENCE_UNSPECIFIED"
            },
            "postOnly": true,
            "price": "string",
            "reduceOnly": true,
            "reference": "string",
            "side": "SIDE_UNSPECIFIED",
            "size": "string",
            "timeInForce": "TIME_IN_FORCE_UNSPECIFIED",
            "type": "TYPE_UNSPECIFIED"
          }
        ]
      },
      "blockHeight": "string",
      "cancelTransfer": {
        "transferId": "string"
      },
      "chainEvent": {
        "builtin": {
          "deposit": {
            "amount": "string",
            "partyId": "string",
            "vegaAssetId": "string"
          },
          "withdrawal": {
            "amount": "string",
            "partyId": "string",
            "vegaAssetId": "string"
          }
        },
        "erc20": {
          "assetDelist": {
            "vegaAssetId": "string"
          },
          "assetLimitsUpdated": {
            "lifetimeLimits": "string",
            "sourceEthereumAddress": "string",
            "vegaAssetId": "string",
            "withdrawThreshold": "string"
          },
          "assetList": {
            "assetSource": "string",
            "vegaAssetId": "string"
          },
          "block": "string",
          "bridgeResumed": true,
          "bridgeStopped": true,
          "deposit": {
            "amount": "string",
            "sourceEthereumAddress": "string",
            "targetPartyId": "string",
            "vegaAssetId": "string"
          },
          "index": "string",
          "withdrawal": {
            "referenceNonce": "string",
            "targetEthereumAddress": "string",
            "vegaAssetId": "string"
          }
        },
        "erc20Multisig": {
          "block": "string",
          "index": "string",
          "signerAdded": {
            "blockTime": "string",
            "newSigner": "string",
            "nonce": "string"
          },
          "signerRemoved": {
            "blockTime": "string",
            "nonce": "string",
            "oldSigner": "string"
          },
          "thresholdSet": {
            "blockTime": "string",
            "newThreshold": 0,
            "nonce": "string"
          }
        },
        "nonce": "string",
        "stakingEvent": {
          "block": "string",
          "index": "string",
          "stakeDeposited": {
            "amount": "string",
            "blockTime": "string",
            "ethereumAddress": "string",
            "vegaPublicKey": "string"
          },
          "stakeRemoved": {
            "amount": "string",
            "blockTime": "string",
            "ethereumAddress": "string",
            "vegaPublicKey": "string"
          },
          "totalSupply": {
            "tokenAddress": "string",
            "totalSupply": "string"
          }
        },
        "txId": "string"
      },
      "delegateSubmission": {
        "amount": "string",
        "nodeId": "string"
      },
      "ethereumKeyRotateSubmission": {
        "currentAddress": "string",
        "ethereumSignature": {
          "algo": "string",
          "value": "string",
          "version": 0
        },
        "newAddress": "string",
        "submitterAddress": "string",
        "targetBlock": "string"
      },
      "issueSignatures": {
        "kind": "NODE_SIGNATURE_KIND_UNSPECIFIED",
        "submitter": "string",
        "validatorNodeId": "string"
      },
      "keyRotateSubmission": {
        "currentPubKeyHash": "string",
        "newPubKey": "string",
        "newPubKeyIndex": 0,
        "targetBlock": "string"
      },
      "liquidityProvisionAmendment": {
        "buys": [
          {
            "offset": "string",
            "proportion": 0,
            "reference": "PEGGED_REFERENCE_UNSPECIFIED"
          }
        ],
        "commitmentAmount": "string",
        "fee": "string",
        "marketId": "string",
        "reference": "string",
        "sells": [
          {
            "offset": "string",
            "proportion": 0,
            "reference": "PEGGED_REFERENCE_UNSPECIFIED"
          }
        ]
      },
      "liquidityProvisionCancellation": {
        "marketId": "string"
      },
      "liquidityProvisionSubmission": {
        "buys": [
          {
            "offset": "string",
            "proportion": 0,
            "reference": "PEGGED_REFERENCE_UNSPECIFIED"
          }
        ],
        "commitmentAmount": "string",
        "fee": "string",
        "marketId": "string",
        "reference": "string",
        "sells": [
          {
            "offset": "string",
            "proportion": 0,
            "reference": "PEGGED_REFERENCE_UNSPECIFIED"
          }
        ]
      },
      "nodeSignature": {
        "id": "string",
        "kind": "NODE_SIGNATURE_KIND_UNSPECIFIED",
        "sig": "string"
      },
      "nodeVote": {
        "reference": "string",
        "type": "TYPE_UNSPECIFIED"
      },
      "nonce": "string",
      "oracleDataSubmission": {
        "payload": "string",
        "source": "ORACLE_SOURCE_UNSPECIFIED"
      },
      "orderAmendment": {
        "expiresAt": "string",
        "marketId": "string",
        "orderId": "string",
        "peggedOffset": "string",
        "peggedReference": "PEGGED_REFERENCE_UNSPECIFIED",
        "price": "string",
        "sizeDelta": "string",
        "timeInForce": "TIME_IN_FORCE_UNSPECIFIED"
      },
      "orderCancellation": {
        "marketId": "string",
        "orderId": "string"
      },
      "orderSubmission": {
        "expiresAt": "string",
        "marketId": "string",
        "peggedOrder": {
          "offset": "string",
          "reference": "PEGGED_REFERENCE_UNSPECIFIED"
        },
        "postOnly": true,
        "price": "string",
        "reduceOnly": true,
        "reference": "string",
        "side": "SIDE_UNSPECIFIED",
        "size": "string",
        "timeInForce": "TIME_IN_FORCE_UNSPECIFIED",
        "type": "TYPE_UNSPECIFIED"
      },
      "proposalSubmission": {
        "rationale": {
          "description": "string",
          "title": "string"
        },
        "reference": "string",
        "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"
        }
      },
      "protocolUpgradeProposal": {
        "upgradeBlockHeight": "string",
        "vegaReleaseTag": "string"
      },
      "stateVariableProposal": {
        "proposal": {
          "eventId": "string",
          "kvb": [
            {
              "key": "string",
              "tolerance": "string",
              "value": {
                "matrixVal": {
                  "value": [
                    {
                      "value": [
                        "string"
                      ]
                    }
                  ]
                },
                "scalarVal": {
                  "value": "string"
                },
                "vectorVal": {
                  "value": [
                    "string"
                  ]
                }
              }
            }
          ],
          "stateVarId": "string"
        }
      },
      "transfer": {
        "amount": "string",
        "asset": "string",
        "fromAccountType": "ACCOUNT_TYPE_UNSPECIFIED",
        "oneOff": {
          "deliverOn": "string"
        },
        "recurring": {
          "dispatchStrategy": {
            "assetForMetric": "string",
            "markets": [
              "string"
            ],
            "metric": "DISPATCH_METRIC_UNSPECIFIED"
          },
          "endEpoch": "string",
          "factor": "string",
          "startEpoch": "string"
        },
        "reference": "string",
        "to": "string",
        "toAccountType": "ACCOUNT_TYPE_UNSPECIFIED"
      },
      "undelegateSubmission": {
        "amount": "string",
        "method": "METHOD_UNSPECIFIED",
        "nodeId": "string"
      },
      "validatorHeartbeat": {
        "ethereumSignature": {
          "algo": "string",
          "value": "string",
          "version": 0
        },
        "message": "string",
        "nodeId": "string",
        "vegaSignature": {
          "algo": "string",
          "value": "string",
          "version": 0
        }
      },
      "voteSubmission": {
        "proposalId": "string",
        "value": "VALUE_UNSPECIFIED"
      },
      "withdrawSubmission": {
        "amount": "string",
        "asset": "string",
        "ext": {
          "erc20": {
            "receiverAddress": "string"
          }
        }
      }
    },
    "cursor": "string",
    "error": "string",
    "hash": "string",
    "index": 0,
    "signature": {
      "algo": "string",
      "value": "string",
      "version": 0
    },
    "submitter": "string",
    "type": "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"
}

Loading...