Skip to main content

BatchGetTransactions gRPC Method

Retrieves multiple transactions from the network.

Updated on
Mar 26, 2026

Parameters

digests
array
REQUIRED

Array of transaction digests to retrieve

read_mask
object

Field mask specifying which fields of the checkpoint to include in the response.

paths
array

List of field names to include (e.g., 'transaction', 'digest' etc). If omitted, defaults to 'digest'.

Returns

transactions
array

An array of transactions

digest
string

The unique transaction digest/hash that identifies this transaction

transaction
object

The transaction object which contains the following fields:

bcs
object

The bcs object which contains the following fields:

name
string

The name of the BCS-serialized type.

value
string

Base64 encoded BCS representation of the transaction

digest
string

Transaction digest matching the root digest

version
integer

Transaction format version number

kind
object

The kind object which contains the following fields:

programmableTransaction
object

The programmableTransaction object which contains the following fields:

inputs
array

An array of inputs

kind
string

Type of input (e.g., 'SHARED', 'PURE', 'INPUT', 'RESULT')

objectId
string

Sui object ID if input is an object

mutable
boolean

Whether the object can be mutated by the transaction

pure
string

Base64-encoded pure value for PURE input types

version
string

Object version number

digest
string

Object content digest

commands
array

A sequence of programmable commands—such as move_call, transferObjects, splitCoins, mergeCoins, makeMoveVec, publish, upgrade, transferSui, pay, paySui, payAllSui, withdraw, deposit, and deleteObject—used to perform operations like coin manipulation, swaps, and transfers. The exact commands and their fields depend on the specific actions required by the transaction

moveCall
object

The moveCall object which contains the following fields:

package
string

The Sui package ID containing the function

module
string

The module name within the package

function
string

The function name to call

typeArguments
array

Array of type arguments for generic functions

arguments
array

Array of arguments passed to the function

kind
string

Type of argument (e.g., 'INPUT', 'RESULT')

input
integer

Index of the input argument

result
integer

Index of the result from previous command

sender
string

The Sui address that initiated and signed this transaction

gasPayment
object

The gasPayment object which contains the following fields:

objects
array

An array of objects

objectId
string

The Sui coin object ID used for gas

version
string

Version of the gas coin object

digest
string

Content digest of the gas coin

owner
string

Owner address of the gas payment objects

price
string

Gas price in MIST per gas unit

budget
string

Maximum gas budget for the transaction

expiration
object

The expiration object which contains the following fields:

kind
string

Expiration type (e.g., 'None', 'Epoch')

effects
object

The effects object which contains the following fields:

bcs
object

The bcs object which contains the following fields:

name
string

The name of the BCS-serialized type.

value
string

Base64 encoded BCS representation of the effects

digest
string

Effects digest hash

version
integer

Effects format version number

status
object

The status object which contains the following fields:

success
boolean

Whether the transaction executed successfully

epoch
string

The epoch number when the transaction was executed

gasUsed
object

The gas_used object which contains the following fields:

computationCost
string

Gas units consumed for computation

storageCost
string

Gas units consumed for storage

storageRebate
string

Gas units refunded from storage cleanup

nonRefundableStorageFee
string

Permanent storage fee that cannot be refunded

transactionDigest
string

The digest of the transaction that produced these effects

gasObject
object

The gas_object object which contains the following fields:

objectId
string

The gas coin object ID

inputState
string

Initial state of the gas object

inputVersion
string

Initial version of the gas object

inputDigest
string

Initial digest of the gas object

inputOwner
object

The input_owner object which contains the following fields:

kind
string

Owner type (e.g., 'ADDRESS', 'OBJECT', 'SHARED')

address
string

Owner's Sui address

outputState
string

Final state of the gas object after transaction

outputVersion
string

Final version of the gas object

outputDigest
string

Final digest of the gas object

outputOwner
object

The output_owner object which contains the following fields:

kind
string

Owner type after transaction

address
string

Owner's Sui address after transaction

idOperation
string

Operation performed on the object ID

eventsDigest
string

Digest of all events emitted by the transaction

dependencies
array

Array of transaction digests that this transaction depends on

lamportVersion
string

Global ordering version for the transaction

changedObjects
array

An array of changedObjects

objectId
string

ID of the object that was changed

inputState
string

State of the object before the transaction

inputVersion
string

Version of the object before the transaction

inputDigest
string

Digest of the object before the transaction

inputOwner
object

The input_owner object which contains the following fields:

kind
string

Owner type before the change

address
string

Owner address before the change

outputState
string

State of the object after the transaction

outputVersion
string

Version of the object after the transaction

outputDigest
string

Digest of the object after the transaction

outputOwner
object

The output_owner object which contains the following fields:

kind
string

Owner type after the change

address
string

Owner address after the change

idOperation
string

Operation performed on this object

objectType
string

The type of the object that was changed

unchangedConsensusObjects
array

An array of unchanged_consensus_objects

kind
string

Type of consensus object reference (e.g., 'READ_ONLY_ROOT')

objectId
string

ID of the consensus object

version
string

Version of the consensus object

digest
string

Digest of the consensus object

events
object

The events object which contains the following fields:

bcs
object

The bcs object which contains the following fields:

name
string

The name of the BCS-serialized type.

value
string

Base64 encoded BCS representation of the events

digest
string

Digest hash of all events

events
array

An array of events

packageId
string

ID of the package that emitted the event

module
string

Module name that emitted the event

sender
string

Transaction sender address

eventType
string

Full type name of the event

contents
object

The contents object which contains the following fields:

name
string

Field name in the event struct

value
string

Base64-encoded field value in the event struct

json
object

JSON representation of the event data with decoded fields

balanceManagerId
string

The balance manager ID associated with the order

baseAssetQuantityCanceled
string

The quantity of base asset that was canceled

clientOrderId
string

The client-generated order identifier

isBid
boolean

Indicates whether this is a bid order (true) or ask order (false)

orderId
string

The unique order identifier in the system

originalQuantity
string

The original quantity of the order before any fills or cancellations

poolId
string

The ID of the trading pool where this order was placed

price
string

The price at which the order was placed

timestamp
string

The timestamp when the order event occurred

trader
string

The address of the trader who placed the order

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free