Submit transaction

Submit a signed transaction

application/json

Request Body required

tx object

Represents a transaction to be sent to Vega.

address string

inputData byte

pow object

Proof of work contains the random transaction id used by the client and the nonce.

nonce uint64

tid string

pubKey string

signature object

Signature of the input data.

algo string

value string

version int64

version string

Possible values: [TX_VERSION_UNSPECIFIED, TX_VERSION_V2, TX_VERSION_V3]

type Type of transaction request, for example ASYNC, meaning the transaction will be submitted and not block on a response

Possible values: [TYPE_UNSPECIFIED, TYPE_ASYNC, TYPE_SYNC, TYPE_COMMIT]

Responses

• 200
• default

---

A successful response.

application/json

Schema

Example (from schema)

---

Schema

code int64
data Data for details
height int64
log string
success Success will be true if the transaction was accepted by the node, **Important** - success does not mean that the event is confirmed by consensus
txHash Hash of the transaction, if accepted

{
  "code": 0,
  "data": "string",
  "height": "string",
  "log": "string",
  "success": true,
  "txHash": "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"
}

POST /transaction

Request

Base URL

https://n06.testnet.vega.xyz

Body required

{
  "tx": {
    "address": "string",
    "inputData": "string",
    "pow": {
      "nonce": "string",
      "tid": "string"
    },
    "pubKey": "string",
    "signature": {
      "algo": "string",
      "value": "string",
      "version": 0
    },
    "version": "TX_VERSION_UNSPECIFIED"
  },
  "type": "TYPE_UNSPECIFIED"
}

curl / cURL

curl -L -X POST 'https://n06.testnet.vega.xyz/transaction' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "tx": {
    "address": "string",
    "inputData": "string",
    "pow": {
      "nonce": "string",
      "tid": "string"
    },
    "pubKey": "string",
    "signature": {
      "algo": "string",
      "value": "string",
      "version": 0
    },
    "version": "TX_VERSION_UNSPECIFIED"
  },
  "type": "TYPE_UNSPECIFIED"
}'

python / requests

curl -L -X POST 'https://n06.testnet.vega.xyz/transaction' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "tx": {
    "address": "string",
    "inputData": "string",
    "pow": {
      "nonce": "string",
      "tid": "string"
    },
    "pubKey": "string",
    "signature": {
      "algo": "string",
      "value": "string",
      "version": 0
    },
    "version": "TX_VERSION_UNSPECIFIED"
  },
  "type": "TYPE_UNSPECIFIED"
}'

go / native

curl -L -X POST 'https://n06.testnet.vega.xyz/transaction' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "tx": {
    "address": "string",
    "inputData": "string",
    "pow": {
      "nonce": "string",
      "tid": "string"
    },
    "pubKey": "string",
    "signature": {
      "algo": "string",
      "value": "string",
      "version": 0
    },
    "version": "TX_VERSION_UNSPECIFIED"
  },
  "type": "TYPE_UNSPECIFIED"
}'

nodejs / axios

curl -L -X POST 'https://n06.testnet.vega.xyz/transaction' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "tx": {
    "address": "string",
    "inputData": "string",
    "pow": {
      "nonce": "string",
      "tid": "string"
    },
    "pubKey": "string",
    "signature": {
      "algo": "string",
      "value": "string",
      "version": 0
    },
    "version": "TX_VERSION_UNSPECIFIED"
  },
  "type": "TYPE_UNSPECIFIED"
}'