/v1/transactions/batch REST API Endpoint

Body Parameters

sender string REQUIRED: The account from which the transaction was sent

sequence_number string REQUIRED: The sequence of a transaction sent by the specific sender

max_gas_amount string REQUIRED: The maximum amount of gas allocated for the execution of a transaction

gas_unit_price string REQUIRED: The cost per unit of gas, determining the transaction fee paid by the sender for each unit of computational resource consumed

expiration_timestamp_secs string REQUIRED: The timestamp indicating the expiration period of a transaction, specifying the time until which the transaction can be included in a block

payload object REQUIRED: The data that is being carried by a transaction. It contains the following fields:

type string: The type of payload indicating the purpose of the data contained

function string: The function associated with the payload

type_arguments array: An array specifying the types of arguments provided to the function

arguments array: An array containing the actual arguments passed to the function

signature object REQUIRED: An array with the following fields:

type string: The type of signature used to verify the authenticity of the function

public_key string: The public key associated with the account that generated the signature, used for verifying the signature's validity

signature string: The actual signature generated using the private key corresponding to the public key provided

Returns

transaction_failures

An array that contains information about any transaction failures within the batch:

error

It describes the error encountered during the transaction failure:

message: The error message associated with the failure

error_code: An error code indicating the type of failure, such as account_not_found

vm_error_code: The virtual machine error code associated with the failure

transaction_index: The index of the failed transaction within the batch

Request

1
curl --request POST \
2
  --url https://docs-demo.aptos-mainnet.quiknode.pro/v1/transactions/batch \
3
  --header 'Accept: application/json, application/x-bcs' \
4
  --header 'Content-Type: application/json' \
5
  --data '[
6
  {
7
    "sender": "SENDER_ADDRESS",
8
    "sequence_number": "SEQUENCE_NUMBER",
9
    "max_gas_amount": "MAX_GAS_AMOUNT",
10
    "gas_unit_price": "GAS_UNIT_PRICE",
11
    "expiration_timestamp_secs": "EXPIRATION_TIMESTAMP_SECS",
12
    "payload": {
13
      "type": "PAYLOAD_TYPE",
14
      "function": "FUNCTION",
15
      "type_arguments": [
16
        "string"
17
      ],
18
      "arguments": [
19
        null
20
      ]
21
    },
22
    "signature": {
23
      "type": "SIGNATURE_TYPE",
24
      "public_key": "PUBLIC_KEY",
25
      "signature": "SIGNATURE"
26
    }
27
  }
28
]'

1
curl --request POST \
2
  --url https://docs-demo.aptos-mainnet.quiknode.pro/v1/transactions/batch \
3
  --header 'Accept: application/json, application/x-bcs' \
4
  --header 'Content-Type: application/json' \
5
  --data '[
6
  {
7
    "sender": "SENDER_ADDRESS",
8
    "sequence_number": "SEQUENCE_NUMBER",
9
    "max_gas_amount": "MAX_GAS_AMOUNT",
10
    "gas_unit_price": "GAS_UNIT_PRICE",
11
    "expiration_timestamp_secs": "EXPIRATION_TIMESTAMP_SECS",
12
    "payload": {
13
      "type": "PAYLOAD_TYPE",
14
      "function": "FUNCTION",
15
      "type_arguments": [
16
        "string"
17
      ],
18
      "arguments": [
19
        null
20
      ]
21
    },
22
    "signature": {
23
      "type": "SIGNATURE_TYPE",
24
      "public_key": "PUBLIC_KEY",
25
      "signature": "SIGNATURE"
26
    }
27
  }
28
]'

1
require 'net/http'
2
require 'json'
3

4
url = URI.parse('https://docs-demo.aptos-mainnet.quiknode.pro/v1/transactions/batch')
5
http = Net::HTTP.new(url.host, url.port)
6
http.use_ssl = true
7

8
headers = {
9
  'Accept' => 'application/json, application/x-bcs',
10
  'Content-Type' => 'application/json'
11
}
12

13
data = [
14
  {
15
    "sender" => "SENDER_ADDRESS",
16
    "sequence_number" => "SEQUENCE_NUMBER",
17
    "max_gas_amount" => "MAX_GAS_AMOUNT",
18
    "gas_unit_price" => "GAS_UNIT_PRICE",
19
    "expiration_timestamp_secs" => "EXPIRATION_TIMESTAMP_SECS",
20
    "payload" => {
21
      "type" => "PAYLOAD_TYPE",
22
      "function" => "FUNCTION",
23
      "type_arguments" => [
24
        "string"
25
      ],
26
      "arguments" => [
27
        nil
28
      ]
29
    },
30
    "signature" => {
31
      "type" => "SIGNATURE_TYPE",
32
      "public_key" => "PUBLIC_KEY",
33
      "signature" => "SIGNATURE"
34
    }
35
  }
36
]
37

38
request = Net::HTTP::Post.new(url.path, headers)
39
request.body = data.to_json
40

41
response = http.request(request)
42
puts response.body
43

1
require 'net/http'
2
require 'json'
3

4
url = URI.parse('https://docs-demo.aptos-mainnet.quiknode.pro/v1/transactions/batch')
5
http = Net::HTTP.new(url.host, url.port)
6
http.use_ssl = true
7

8
headers = {
9
  'Accept' => 'application/json, application/x-bcs',
10
  'Content-Type' => 'application/json'
11
}
12

13
data = [
14
  {
15
    "sender" => "SENDER_ADDRESS",
16
    "sequence_number" => "SEQUENCE_NUMBER",
17
    "max_gas_amount" => "MAX_GAS_AMOUNT",
18
    "gas_unit_price" => "GAS_UNIT_PRICE",
19
    "expiration_timestamp_secs" => "EXPIRATION_TIMESTAMP_SECS",
20
    "payload" => {
21
      "type" => "PAYLOAD_TYPE",
22
      "function" => "FUNCTION",
23
      "type_arguments" => [
24
        "string"
25
      ],
26
      "arguments" => [
27
        nil
28
      ]
29
    },
30
    "signature" => {
31
      "type" => "SIGNATURE_TYPE",
32
      "public_key" => "PUBLIC_KEY",
33
      "signature" => "SIGNATURE"
34
    }
35
  }
36
]
37

38
request = Net::HTTP::Post.new(url.path, headers)
39
request.body = data.to_json
40

41
response = http.request(request)
42
puts response.body
43

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free