/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
]'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free