Console

POSTSimulate transaction

API that simulates a transaction without actually executing it.

The simulation result includes the same transaction output and events as when executing an actual signed transaction. However, the state hash is not included because storage is not updated. You can use this API to estimate the maximum gas amount required when submitting a transaction.

How to use:

  • Create a transaction with zero-padded signatures.
  • Submit the created transaction to this API.

To use this endpoint in BCS format, you must submit a signed transaction encoded in BCS.

Query Parameters
estimate_gas_priceboolean

When set to True, the transaction's gas unit price is ignored and the estimated value is used.

estimate_max_gasboolean

When set to True, the transaction's max gas amount is ignored and the estimated value is used.

estimate_prioritized_gas_uint_priceboolean

When set to True, the transaction is executed at a higher price than the estimate.

Request Body
senderstringrequired

A field representing the address of the account that sent the transaction. When expressed as a string, it is displayed as a 64-character hexadecimal string, and may be abbreviated by omitting leading zeros and adding 0x.

sequence_numberstringrequired

A field representing the transaction occurrence order. Represents a 64-bit unsigned integer as a string.

max_gas_amountstringrequired

A field representing the maximum amount of gas to use when the transaction occurs. Represents a 64-bit unsigned integer as a string.

gas_unit_pricestringrequired

A field representing the gas price to use when the transaction occurs. Represents a 64-bit unsigned integer as a string.

expiration_timestamp_secsstringrequired

A field representing the transaction expiration time. Represents a 64-bit unsigned integer as a string.

payloadoneOfrequired

A field representing the payload to use when the transaction occurs.

typestring (enum)required

The type of the payload

functionstringrequired

String representation of the Entry Function identifier defined on-chain.

type_argumentsstring[]required

Field representing the generic type arguments of the Entry function.

argumentsoneOf[]required

Field representing the arguments of the Entry function.

arguments[0]string
arguments[1]string
replay_protection_noncestringrequired

A field representing the nonce used to prevent transaction replay attacks. Represents a 64-bit unsigned integer as a string.

signatureoneOfrequired

A field representing the transaction signature. One of Ed25519, MultiEd25519, MultiAgent, FeePayer, Account, or NoAccount can be selected.

typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Responses
Headers
X-APTOS-BLOCK-HEIGHTintegerrequired

Current block height of the chain

예: 0

X-APTOS-CHAIN-IDintegerrequired

Chain ID of the current chain

예: 0

X-APTOS-EPOCHintegerrequired

Current epoch of the chain

예: 0

X-APTOS-LEDGER-OLDEST-VERSIONintegerrequired

Oldest unpruned ledger version of the chain

예: 0

X-APTOS-LEDGER-TIMESTAMPUSECintegerrequired

Current timestamp of the chain

예: 0

X-APTOS-LEDGER-VERSIONintegerrequired

Current ledger version of the chain

예: 0

X-APTOS-OLDEST-BLOCK-HEIGHTintegerrequired

Oldest unpruned block height of the chain

예: 0

X-APTOS-CURSORstring

Cursor for the next page

예: string

X-APTOS-GAS-USEDinteger

Amount of gas actually used for transaction execution

예: 0

Body
typestring (enum)required

The type of the transaction

hashstringrequired

A field representing the unique identifier of the transaction, provided as a 64-character hexadecimal string starting with 0x.

senderstringrequired

A field representing the address of the account that sent the transaction. When expressed as a string, it is displayed as a 64-character hexadecimal string, and may be abbreviated by omitting leading zeros and adding 0x.

예: 0x1

sequence_numberstringrequired

A field representing the transaction occurrence order. Represents a 64-bit unsigned integer as a string.

예: 1234567890

max_gas_amountstringrequired

A field representing the maximum amount of gas to use when the transaction occurs. Represents a 64-bit unsigned integer as a string.

예: 1000000

gas_unit_pricestringrequired

A field representing the gas price to use when the transaction occurs. Represents a 64-bit unsigned integer as a string.

예: 1

expiration_timestamp_secsstringrequired

A field representing the transaction expiration time. Represents a 64-bit unsigned integer as a string.

예: 1634567890

payloadoneOfrequired
object 1object
typestring (enum)required

The type of the payload

functionstringrequired

String representation of the Entry Function identifier defined on-chain.

예: 0x1::coin::transfer

type_argumentsstring[]required

Field representing the generic type arguments of the Entry function.

argumentsoneOf[]required

Field representing the arguments of the Entry function.

예: 3,pts_1762134251280_impression_3119,0x01,0x01,Points event for user 04344295 - Type impression - Points 3,1762134251280,batch_impression_1762134251280

string 1string
array 2any[]
object 2object
typestring (enum)required

The type of the payload

codeobjectrequired

Move script bytecode

bytecodestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

abiobject

A Move module

addressstringrequired

A 32-byte Aptos account address encoded in hexadecimal. When expressed as a string, it is a 64-character hexadecimal string. It may be abbreviated by omitting leading zeros and adding 0x prefix. For example, the address 0x0000000000000000000000000000000000000000000000000000000000000001 can be expressed as 0x1.

예: 0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1

namestringrequired
friendsstring[]required

Friends of the module

exposed_functionsobject[][]required
structsobject[]required
namestringrequired
is_nativebooleanrequired
is_eventboolean

Whether the struct is an event struct

is_enumboolean

Whether the struct is an enum

abilitiesstring[]required

Ability associated with the Move struct

generic_type_paramsobject[]required

Generic type parameters associated with the Move function.

fieldsobject[]required
type_argumentsstring[]required

Field representing the generic type arguments of the Entry function.

argumentsoneOf[]required

Field representing the arguments of the Entry function.

예: 3,pts_1762134251280_impression_3119,0x01,0x01,Points event for user 04344295 - Type impression - Points 3,1762134251280,batch_impression_1762134251280

string 1string
array 2any[]
object 3object
typestring (enum)required

The type of the payload

object 4object
typestring (enum)required

The type of the payload

multisig_addressstringrequired

Aptos account address expressed as a hexadecimal string. This is represented as a 64-character hexadecimal string, sometimes abbreviated as a 64-character hex string with a 0x prefix. For example, the address 0x0000000000000000000000000000000000000000000000000000000000000001 can be expressed as 0x1.

transaction_payloadobject

Payload that executes a single Entry Function

typestring (enum)required

The type of the payload

functionstringrequired

String representation of the Entry Function identifier defined on-chain.

예: 0x1::coin::transfer

type_argumentsstring[]required

Field representing the generic type arguments of the Entry function.

argumentsoneOf[]required

Field representing the arguments of the Entry function.

예: 3,pts_1762134251280_impression_3119,0x01,0x01,Points event for user 04344295 - Type impression - Points 3,1762134251280,batch_impression_1762134251280

string 1string
array 2any[]
signatureoneOf
Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keysstring[]required

List of public keys used for the Ed25519 signature.

signaturesstring[]required

List of signatures mapped in the same order as the public keys.

thresholdintegerrequired

The number of signatures required for a successful transaction.

bitmapstringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Agent Signatureobject
typestring (enum)required

The type of the signature

senderoneOfrequired

Account signature scheme

The account signature scheme allows you to have two types of accounts:

A single Ed25519 key account, one private key A k-of-n multi-Ed25519 key account, multiple private keys, such that k-of-n must sign a transaction. A single Secp256k1Ecdsa key account, one private key

Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keysstring[]required

List of public keys used for the Ed25519 signature.

signaturesstring[]required

List of signatures mapped in the same order as the public keys.

thresholdintegerrequired

The number of signatures required for a successful transaction.

bitmapstringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Single Key Signatureobject
typestring (enum)required

The type of the signature

public_keyobjectrequired
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatureobjectrequired
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Key Signatureobject
typestring (enum)required

The type of the signature

public_keysobject[]required
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturesobject[]required
indexinteger

Public key index

signatureobject
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatures_requiredintegerrequired

Minimum number of signatures required for a successful transaction

No Account Signatureobject
typestring (enum)required

The type of the signature

object 6object
typestring (enum)required

The type of the signature

function_infostringrequired
auth_datastringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

secondary_signer_addressesstring[]required

List of addresses of accounts that signed the transaction in addition to the primary signer (sender).

secondary_signersoneOf[]required

List of signatures from accounts that signed the transaction in addition to the primary signer (sender).

Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keysstring[]required

List of public keys used for the Ed25519 signature.

signaturesstring[]required

List of signatures mapped in the same order as the public keys.

thresholdintegerrequired

The number of signatures required for a successful transaction.

bitmapstringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Single Key Signatureobject
typestring (enum)required

The type of the signature

public_keyobjectrequired
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatureobjectrequired
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Key Signatureobject
typestring (enum)required

The type of the signature

public_keysobject[]required
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturesobject[]required
indexinteger

Public key index

signatureobject
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatures_requiredintegerrequired

Minimum number of signatures required for a successful transaction

No Account Signatureobject
typestring (enum)required

The type of the signature

object 6object
typestring (enum)required

The type of the signature

function_infostringrequired
auth_datastringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Fee Payer Signatureobject
typestring (enum)required

The type of the signature

senderoneOfrequired

Account signature scheme

The account signature scheme allows you to have two types of accounts:

A single Ed25519 key account, one private key A k-of-n multi-Ed25519 key account, multiple private keys, such that k-of-n must sign a transaction. A single Secp256k1Ecdsa key account, one private key

Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keysstring[]required

List of public keys used for the Ed25519 signature.

signaturesstring[]required

List of signatures mapped in the same order as the public keys.

thresholdintegerrequired

The number of signatures required for a successful transaction.

bitmapstringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Single Key Signatureobject
typestring (enum)required

The type of the signature

public_keyobjectrequired
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatureobjectrequired
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Key Signatureobject
typestring (enum)required

The type of the signature

public_keysobject[]required
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturesobject[]required
indexinteger

Public key index

signatureobject
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatures_requiredintegerrequired

Minimum number of signatures required for a successful transaction

No Account Signatureobject
typestring (enum)required

The type of the signature

object 6object
typestring (enum)required

The type of the signature

function_infostringrequired
auth_datastringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

secondary_signer_addressesstring[]required

List of addresses of accounts that signed the transaction in addition to the primary signer (sender).

secondary_signersoneOf[]required

List of signatures from accounts that signed the transaction in addition to the primary signer (sender).

Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keysstring[]required

List of public keys used for the Ed25519 signature.

signaturesstring[]required

List of signatures mapped in the same order as the public keys.

thresholdintegerrequired

The number of signatures required for a successful transaction.

bitmapstringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Single Key Signatureobject
typestring (enum)required

The type of the signature

public_keyobjectrequired
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatureobjectrequired
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Key Signatureobject
typestring (enum)required

The type of the signature

public_keysobject[]required
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturesobject[]required
indexinteger

Public key index

signatureobject
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatures_requiredintegerrequired

Minimum number of signatures required for a successful transaction

No Account Signatureobject
typestring (enum)required

The type of the signature

object 6object
typestring (enum)required

The type of the signature

function_infostringrequired
auth_datastringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

fee_payer_addressstringrequired

The address of the account that pays the fee.

fee_payer_signatureoneOfrequired

Account signature scheme

The account signature scheme allows you to have two types of accounts:

A single Ed25519 key account, one private key A k-of-n multi-Ed25519 key account, multiple private keys, such that k-of-n must sign a transaction. A single Secp256k1Ecdsa key account, one private key

Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keystringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturestringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Ed25519 Signatureobject
typestring (enum)required

The type of the signature

public_keysstring[]required

List of public keys used for the Ed25519 signature.

signaturesstring[]required

List of signatures mapped in the same order as the public keys.

thresholdintegerrequired

The number of signatures required for a successful transaction.

bitmapstringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Single Key Signatureobject
typestring (enum)required

The type of the signature

public_keyobjectrequired
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatureobjectrequired
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Multi Key Signatureobject
typestring (enum)required

The type of the signature

public_keysobject[]required
typestring (enum)

The type of the public key

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signaturesobject[]required
indexinteger

Public key index

signatureobject
typestring (enum)

The type of the signature

valuestring

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

signatures_requiredintegerrequired

Minimum number of signatures required for a successful transaction

No Account Signatureobject
typestring (enum)required

The type of the signature

object 6object
typestring (enum)required

The type of the signature

function_infostringrequired
auth_datastringrequired

All byte (Vec) data is expressed as a hex-encoded string starting with 0x, with two hex digits per byte. Unlike the Address type, HexEncodedBytes does not omit any zeros.

Account SignatureoneOf
No Account Signatureobject
typestring (enum)required

The type of the signature

replay_protection_noncestring

A field representing the nonce used to prevent transaction replay attacks. Represents a 64-bit unsigned integer as a string.

예: 590

X-API-KEY
RequestCU26
cURL
curl -X POST "https://aptos-mainnet.nodit.io/v1/transactions/simulate?estimate_gas_price=true&estimate_max_gas=true&estimate_prioritized_gas_uint_price=true" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "sender": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1",
  "sequence_number": "32",
  "max_gas_amount": "2000",
  "gas_unit_price": "100",
  "expiration_timestamp_secs": "1759305600",
  "payload": {
    "type": "entry_function_payload",
    "function": "0x1::aptos_account::transfer",
    "type_arguments": [],
    "arguments": [
      "0xb8726fd47889b2f7b004e1f47c1a784a18527eb01c5818c992c8ae4330dec831",
      "1000000"
    ]
  },
  "signature": {
    "type": "ed25519_signature",
    "public_key": "0x9c9f4163ca8ebe2c25b4f20ba7194b5f8cce7dad64acaff8186bb70125160abf",
    "signature": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
  }
}'
Response
Header · 200
{
  "X-APTOS-BLOCK-HEIGHT": 0,
  "X-APTOS-CHAIN-ID": 0,
  "X-APTOS-EPOCH": 0,
  "X-APTOS-LEDGER-OLDEST-VERSION": 0,
  "X-APTOS-LEDGER-TIMESTAMPUSEC": 0,
  "X-APTOS-LEDGER-VERSION": 0,
  "X-APTOS-OLDEST-BLOCK-HEIGHT": 0,
  "X-APTOS-CURSOR": "string",
  "X-APTOS-GAS-USED": 0
}
Body · 200
[
  {
    "type": "pending_transaction",
    "hash": "string",
    "sender": "0x1",
    "sequence_number": "1234567890",
    "max_gas_amount": "1000000",
    "gas_unit_price": "1",
    "expiration_timestamp_secs": "1634567890",
    "payload": {
      "type": "entry_function_payload",
      "function": "0x1::coin::transfer",
      "type_arguments": [],
      "arguments": [
        [
          "3"
        ],
        [
          "pts_1762134251280_impression_3119"
        ],
        "0x01",
        "0x01",
        [
          "Points event for user 04344295 - Type impression - Points 3"
        ],
        [
          "1762134251280"
        ],
        "batch_impression_1762134251280"
      ]
    },
    "signature": {
      "type": "ed25519_signature",
      "public_key": "string",
      "signature": "string"
    },
    "replay_protection_nonce": "590"
  }
]

Last updated