Submit batch transactions

This allows you to submit multiple transactions. The response has three outcomes:

All transactions succeed, and it will return a 202
Some transactions succeed, and it will return the failed transactions and a 206
No transactions succeed, and it will also return the failed transactions and a 206

To submit a transaction as JSON, you must submit a SubmitTransactionRequest. To build this request, do the following:

Encode the transaction as BCS. If you are using a language that has native BCS support, make sure to use that library. If not, you may take advantage of /transactions/encode_submission. When using this endpoint, make sure you trust the node you’re talking to, as it is possible they could manipulate your request.
Sign the encoded transaction and use it to create a TransactionSignature.
Submit the request. Make sure to use the “application/json” Content-Type.

To submit a transaction as BCS, you must submit a SignedTransaction encoded as BCS. See SignedTransaction in types/src/transaction/mod.rs. Make sure to use the application/x.aptos.signed_transaction+bcs Content-Type.

POST

transactions

batch

Submit batch transactions

curl --request POST \
  --url https://aptos-mainnet.s.chainbase.online/{api-key}/v1/transactions/batch \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "sender": "0xc739507214d0e1bf9795485299d709e00024e92f7c0d055a4c2c39717882bdfd",
    "sequence_number": "32425224034",
    "max_gas_amount": "32425224034",
    "gas_unit_price": "32425224034",
    "expiration_timestamp_secs": "32425224034",
    "payload": {
      "type": "entry_function_payload",
      "function": "0x1::aptos_coin::transfer",
      "type_arguments": [
        "<string>"
      ],
      "arguments": [
        "<any>"
      ]
    },
    "signature": {
      "type": "ed25519_signature",
      "public_key": "0xc739507214d0e1bf9795485299d709e00024e92f7c0d055a4c2c39717882bdfd",
      "signature": "0xc739507214d0e1bf9795485299d709e00024e92f7c0d055a4c2c39717882bdfd"
    }
  }
]'

{
  "transaction_failures": [
    {
      "error": {
        "message": "<string>",
        "error_code": "account_not_found",
        "vm_error_code": 123
      },
      "transaction_index": 123
    }
  ]
}

Body

The body is of type object[].

Response

202

application/json

Batch transaction submission result

Tells which transactions failed

Submit batch transactions

curl --request POST \
  --url https://aptos-mainnet.s.chainbase.online/{api-key}/v1/transactions/batch \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "sender": "0xc739507214d0e1bf9795485299d709e00024e92f7c0d055a4c2c39717882bdfd",
    "sequence_number": "32425224034",
    "max_gas_amount": "32425224034",
    "gas_unit_price": "32425224034",
    "expiration_timestamp_secs": "32425224034",
    "payload": {
      "type": "entry_function_payload",
      "function": "0x1::aptos_coin::transfer",
      "type_arguments": [
        "<string>"
      ],
      "arguments": [
        "<any>"
      ]
    },
    "signature": {
      "type": "ed25519_signature",
      "public_key": "0xc739507214d0e1bf9795485299d709e00024e92f7c0d055a4c2c39717882bdfd",
      "signature": "0xc739507214d0e1bf9795485299d709e00024e92f7c0d055a4c2c39717882bdfd"
    }
  }
]'

{
  "transaction_failures": [
    {
      "error": {
        "message": "<string>",
        "error_code": "account_not_found",
        "vm_error_code": 123
      },
      "transaction_index": 123
    }
  ]
}

API Reference

Web3 API

SQL API

Submit batch transactions

Body

Response