Console

POSTGet Transactions By Versions

Data APIhttps://web3.nodit.io/v1/aptos/mainnet/blockchain/getTransactionsByVersions

Retrieves information for multiple transactions. Up to 1,000 transactions can be queried.

Path Parameters
chainstring (enum)required

Parameter to specify the target chain for the query.

networkstring (enum)required

Parameter to specify the network of the target chain. Supported networks may vary depending on the chain.

Request Body
transactionVersionsinteger[]required

Enter the transaction versions to query as an array.

withBalanceChangesboolean

Parameter specifying whether to include the balanceChanges field in the response.

  • balanceChanges is a field containing balance changes for Native token (APT) and Tokens.
  • Response speed may be slower when true is set for this parameter.
Responses
transactionHashstringrequired

A field that represents the unique identifier of the transaction. A cryptographic hash computed from all transaction data (signed payload), provided as a 64-character hexadecimal string prefixed with 0x. Used to verify transaction integrity and to uniquely identify the transaction.

예: 0x2a41cd44491bb92d4eb17d8487f82d9b43ab6289074c1986ee055be8105707c9

transactionVersionintegerrequired

A field that represents the version of the transaction. A unique sequence ID indicating the order of the transaction on the chain, incrementing sequentially from 0. Used to ensure transaction execution order and to query the state of a specific transaction.

예: 2854257037

blockHeightintegerrequired

A field that represents the height of the block containing the transaction. Provided as an integer that increments sequentially from the genesis block (0). Used to identify which block the transaction was included in and to verify if the transaction has been finalized.

예: 160155267

blockTimestampintegerrequired

A field that represents the creation time of the block containing the transaction. Provided as a UNIX timestamp; this value means both when the block was created and when the transactions in that block were processed.

예: 1749003732416395

expirationTimestampSecsintegerrequired

A field that represents the expiration time of the transaction. Provided as a UNIX timestamp in seconds; the transaction cannot be included in the chain after this time. Sets the validity period of the transaction to prevent old transactions from being processed.

예: 1749003762

gasUnitPricestringrequired

A field that represents the gas unit price of the transaction. Provided in Octas (1 APT = 10^8 Octas); indicates the amount to pay per gas unit. Used to determine transaction processing priority and to calculate transaction fees.

예: 100

gasUsedstringrequired

A field that represents the amount of gas actually consumed during transaction execution. A unit that measures the amount of computing resources consumed for transaction processing. Actual transaction fee is calculated as gasUsed * gasUnitPrice.

예: 678

maxGasAmountstringrequired

A field that represents the maximum amount of gas available for the transaction. The transaction fails if this value is exceeded during execution; serves as a cap on gas cost. Prevents users from paying unexpectedly high fees.

예: 2000

secondarySignersstring[]required

A field that represents the list of addresses of additional signers in a multi-signature transaction. Contains the addresses of accounts that signed the transaction in addition to the primary signer (sender). Used for complex permission management or transactions requiring multiple approvals.

예: 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef,0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890

senderstringrequired

A field that represents the address of the account that initiated the transaction. Provided as a 64-character hexadecimal string prefixed with 0x; identifies the principal of the transaction. The account against which transaction fee payment and sequence number management are applied.

예: 0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a

sequenceNumberintegerrequired

A field that represents the current sequence number of the sender account. Starts at 0 and increments by 1 per transaction per account; prevents replay attacks and ensures transaction order. Transactions with the same sequence number cannot be executed redundantly.

예: 42

successbooleanrequired

A field that indicates whether the transaction executed successfully. true means the transaction was executed successfully; false means an error occurred during execution.

예: true

vmStatusstringrequired

A field that represents the execution result status of the transaction. Returns 'Executed successfully' on success; includes specific error messages on failure. Helps analyze the cause of transaction failures and troubleshoot issues.

예: Executed successfully

eventIndexintegerrequired

A field that represents the order index of the event within the transaction. Indicates the order of the current event among multiple events emitted in a single transaction. Starts at 0 and increments in event emission order; used to identify the order of events within the same transaction.

예: 0

eventTypestringrequired

A field that represents the type of the event. Provided as the full path (address::module::struct) of the event struct defined in the Move module. Used to identify the type of operation that caused the balance change.

예: 0x1::coin::WithdrawEvent

accountAddressstringrequired

A field that represents the address of the resource owner that emitted the event. Provided as a 64-character hexadecimal string prefixed with 0x; identifies the owner of the resource where the event occurred. The account that owns the event handle; can be used as a filter condition when querying events.

예: 0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a

dataobjectrequired

A field that represents the specific data of the event. The fields of the event struct defined in eventType are provided as a JSON object. Contains the event details and may have different structures depending on the event type.

예: [object Object]

creationNumberintegerrequired

A field that represents the creation number of the event handle. A unique identifier to distinguish event handles created by an account, incrementing sequentially from 0. Used to distinguish different types of events emitted from the same account.

예: 2

sequenceNumberintegerrequired

A field that represents the sequence number of the event emitted from the event handle. Indicates the order of events emitted from the same event handle. Starts at 0 and increments sequentially; ensures the time order of events emitted from a specific event handle.

예: 12345

objectAddressstringrequired

A field that represents the address of the Object when the event is for an Object resource. Provided as a 64-character hexadecimal string prefixed with 0x; the unique identifier for Object-based resources. Used to track and query events related to Object resources.

예: 0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b

objectOwnerAddressstringrequired

A field that represents the owner address of the Object identified by objectAddress. Provided as a 64-character hexadecimal string prefixed with 0x; identifies the current owner of the Object. Used for Object ownership tracking and permission verification.

예: 0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a

balanceInAccountsstring[]required

A field that represents the list of addresses of accounts that received assets in the transaction. Contains addresses of accounts with positive values (deposits) in balanceChanges. Used to track asset transfer recipients and analyze deposit history.

예: 0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2

balanceOutAccountsstring[]required

A field that represents the list of addresses of accounts that sent assets in the transaction. Contains addresses of accounts with negative values (withdrawals) in balanceChanges. Used to track asset transfer senders and analyze withdrawal history.

예: 0xb2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3

balanceChangedTokensstring[]required

A field that represents the list of token types whose balances changed due to the transaction. Each token is provided in 'moduleAddress::moduleName::structName' format. Used to identify the types of assets affected by the transaction and to track changes per asset.

예: 0x1::aptos_coin::AptosCoin,0x1::usdc::USDC

functionstringrequired

A field that represents the full identifier of the on-chain function being invoked. Provided in 'address::moduleName::functionName' format; uniquely identifies the Module function to be executed.

예: 0x1::coin::transfer

typestringrequired

A field that represents the type of the payload. The following values are possible:

  • entry_function_payload: Directly invokes an entry function of a Move module
  • script_payload: Executes a Move script
  • multisig_payload: Transaction requiring multi-signature The execution method and required arguments of the transaction are determined by this value.

예: entry_function_payload

typeArgumentsstring[]required

A field that represents the type arguments used when calling a generic function.

예: 0x1::aptos_coin::AptosCoin

argumentsstring[]required

A field that represents the arguments passed to the invoked function. Values must be provided in order matching the function parameters; parameter types and count differ per function.

예: 0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a,1000000

entryFunctionContractAddressstring

A field that represents the module address of the called entry function. Only provided when the payload type is entry_function_payload.

예: 0x1

entryFunctionIdStrstring

A field that represents the full identifier of the called entry function. Provided in 'moduleAddress::moduleName::functionName' format. Only provided when the payload type is entry_function_payload.

예: 0x1::coin::transfer

entryFunctionModuleNamestring

A field that represents the module name of the called entry function. Only provided when the payload type is entry_function_payload.

예: coin

entryFunctionNamestring

A field that represents the name of the called entry function. Only provided when the payload type is entry_function_payload.

예: transfer

blockHeightinteger

A field that represents the height of the block containing this balance change. An integer that increments sequentially starting from the genesis block (0), used as an indicator for the blockchain length and the position of a specific block.

예: 160155267

blockTimestampinteger

A field that represents the block creation time. Provided as a UNIX timestamp, used for block creation order and time tracking. Block timestamps are used to ensure transaction order and measure inter-block creation intervals.

예: 1749003732416395

transactionHashstring

A field that represents the hash of the transaction that caused the balance change. A cryptographic hash computed from all transaction data, provided as a 64-character hexadecimal string prefixed with 0x. This hash enables retrieval of full information for the transaction related to the balance change.

예: 0x2a41cd44491bb92d4eb17d8487f82d9b43ab6289074c1986ee055be8105707c9

transactionVersioninteger

A field that represents the version of the transaction where the balance change occurred. A unique sequence ID indicating the order of the transaction on the chain, incrementing sequentially from 0.

예: 34872482

eventIndexintegerrequired

A field that represents the order index of the event within the transaction. Indicates the order of the current event among multiple events emitted in a single transaction. Starts at 0 and increments in event emission order; used to identify the order of events within the same transaction.

예: 0

eventTypestringrequired

A field that represents the type of the event. Provided as the full path (address::module::struct) of the event struct defined in the Move module. Used to identify the type of operation that caused the balance change.

예: 0x1::coin::WithdrawEvent

subEventIndexintegerrequired

A field that represents the order of asset changes when multiple asset changes occur within a single event. Identifies the order of multiple asset changes within an event sharing the same eventIndex. Starts at 0 and increments sequentially; plays an important role in complex asset operations (e.g., swaps).

예: 0

accountAddressstringrequired

A field that represents the address of the account where the balance change occurred. Provided as a 64-character hexadecimal string prefixed with 0x; identifies the account whose asset balance changed. This address is either the asset owner or the destination account the asset was transferred to.

예: 0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a

assetTypestringrequired

A field that represents the type of the asset whose balance changed. Provided in one of two formats:

  • Coin: Asset ID in Move struct format (e.g., 0x1::aptos_coin::AptosCoin)
  • Fungible Asset: Object address that owns the metadata of the asset Used to uniquely identify the type of asset.

예: 0x1::aptos_coin::AptosCoin

linkedAssetTypestringrequired

A common identifier that links Coin and Fungible Asset when they have been migrated. This field serves as a unified key that groups Coin/Fungible Asset into a single asset unit for identification and retrieval, providing the Object address where the migrated Fungible Asset's Metadata is stored.

예: 0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b

changeValuestringrequired

A field that represents the balance change amount. Provided as a string in integer form.

  • Positive: indicates the account balance increased
  • Negative: indicates the account balance decreased The actual value must be interpreted considering decimals.

예: 1000000

tokenStandardstringrequired

A field that represents the standard type of the asset.

  • v1: Assets following the Coin standard
  • v2: Assets following the Fungible Asset standard

예: coin

transferTypestringrequired

A field that represents the transfer direction or action type. Indicates the specific type of balance change; the following values are possible:

  • deposit: asset deposit
  • withdraw: asset withdrawal
  • swap_in: deposit from swap
  • swap_out: withdrawal from swap
  • gas: gas fee payment
  • refund_gas: gas fee refund

예: deposit

X-API-KEY
RequestCU500
cURL
curl -X POST "https://web3.nodit.io/v1/aptos/mainnet/blockchain/getTransactionsByVersions" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "transactionVersions": [3102207414, 3102479727],
  "withBalanceChanges": false
}'
Response
Example · 200
[
  {
    "transactionHash": "0x2a41cd44491bb92d4eb17d8487f82d9b43ab6289074c1986ee055be8105707c9",
    "transactionVersion": 2854257037,
    "blockHeight": 160155267,
    "blockTimestamp": 1749003732416395,
    "expirationTimestampSecs": 1749003762,
    "gasUnitPrice": "100",
    "gasUsed": "678",
    "maxGasAmount": "2000",
    "secondarySigners": [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ],
    "sender": "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a",
    "sequenceNumber": 42,
    "success": true,
    "vmStatus": "Executed successfully",
    "events": [
      {
        "eventIndex": 0,
        "eventType": "0x1::coin::WithdrawEvent",
        "accountAddress": "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a",
        "data": {
          "amount": "1000000",
          "from": "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a",
          "to": "0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
        },
        "creationNumber": 2,
        "sequenceNumber": 12345,
        "objectAddress": "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b",
        "objectOwnerAddress": "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a"
      }
    ],
    "balanceInAccounts": [
      "0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
    ],
    "balanceOutAccounts": [
      "0xb2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3"
    ],
    "balanceChangedTokens": [
      "0x1::aptos_coin::AptosCoin",
      "0x1::usdc::USDC"
    ],
    "payload": {
      "function": "0x1::coin::transfer",
      "type": "entry_function_payload",
      "typeArguments": [
        "0x1::aptos_coin::AptosCoin"
      ],
      "arguments": [
        "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a",
        "1000000"
      ]
    },
    "entryFunctionContractAddress": "0x1",
    "entryFunctionIdStr": "0x1::coin::transfer",
    "entryFunctionModuleName": "coin",
    "entryFunctionName": "transfer",
    "balanceChanges": [
      {
        "blockHeight": 160155267,
        "blockTimestamp": 1749003732416395,
        "transactionHash": "0x2a41cd44491bb92d4eb17d8487f82d9b43ab6289074c1986ee055be8105707c9",
        "transactionVersion": 34872482,
        "eventIndex": 0,
        "eventType": "0x1::coin::WithdrawEvent",
        "subEventIndex": 0,
        "accountAddress": "0x948592877d14d0fde0a42e2fc15a56959f30ea35d0b87c7ee8e98e0cce756f1a",
        "assetType": "0x1::aptos_coin::AptosCoin",
        "linkedAssetType": "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b",
        "changeValue": "1000000",
        "tokenStandard": "coin",
        "transferType": "deposit"
      }
    ]
  }
]

Last updated