Skip to main content

tx RPC Method

Retrieves information on a single transaction, by its identifying hash

Updated on
Oct 4, 2023

tx RPC Method

Parameters

transaction
string
REQUIRED
The 256-bit hash of the transaction, as hex
binary
boolean
If true, return transaction data and metadata as binary serialized to hexadecimal strings
min_ledger
integer
It is used with max_ledger to specify a range of up to 1000 ledger indexes, starting with this ledger (inclusive)
max_ledger
integer
It is used with min_ledger to specify a range of up to 1000 ledger indexes, ending with this ledger (inclusive)

Returns

result
object
An object which contains the following fields:
Account
string
The unique address of the account that initiated the transaction
Amount
string
The amount of the transaction
Destination
string
The recipient of the transaction
Fee
string
The amount of XRP, in drops, to be destroyed as a cost for distributing this transaction to the network
Flags
integer
The set of bit-flags for this transaction
LastLedgerSequence
integer
The highest ledger index this transaction can appear in
Memos
array
The additional arbitrary information used to identify this transaction
Sequence
integer
The sequence number of the account sending the transaction
SigningPubKey
string
The hex representation of the public key that corresponds to the private key used to sign this transaction
TransactionType
string
The type of transaction. Valid transaction types include: Payment, OfferCreate, TrustSet, and many others
TxnSignature
string
The signature that verifies this transaction as originating from the account it says it is from
hash
string
The hash of the transaction
metadata
object
The metadata object which contain the following fields:
AffectedNodes
array
The AffectedNodes object which contain the following fields:
ModifiedNode
object
The ModifiedNode object which contain the following fields:
FinalFields
object
The content fields of the ledger object after applying any changes from this transaction
Account
string
The account related to the modified node
Balance
string
The balance of the account
Flags
integer
The set of bit-flags for this transaction
OwnerCount
integer
The number of owners for the account
Sequence
integer
The sequence number of the account
LedgerEntryType
string
The type of ledger object that was deleted
LedgerIndex
string
The ID of this ledger object in the ledger's state tree
PreviousFields
object
The previous values for all fields of the object that were changed as a result of this transaction
Balance
string
The previous balance of the account
Sequence
integer
The previous sequence number of the account
PreviousTxnID
string
The identifying hash of the previous transaction to modify this ledger object
PreviousTxnLgrSeq
integer
The Ledger Index of the ledger version containing the previous transaction to modify this ledger object
TransactionIndex
integer
The transaction's position within the ledger that included it
TransactionResult
string
A result code indicating whether the transaction succeeded or how it failed
delivered_amount
string
The currency Amount actually received by the Destination account
ledger_index
integer
The index of the ledger to retrieve information from
date
integer
The timestamp of the transaction, represented as the number of seconds since the Unix epoch
validated
boolean
It indicates whether the result has been validated
status
string
The status of the request
warnings
array
An array of warning objects, each containing the following fields:
id
integer
The ID of the warning
message
string
The warning message
Request
1
curl https://docs-demo.xrp-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "method": "tx",
6
    "params": [{
7
        "transaction": "71A26ED3AD40802121D0C56DAAFA4C7ACC421153312312B701D1B23E8C6E2306",
8
        "binary": false
9
    }],"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free