getTransactions RPC Method

Parameters

startLedger

string

REQUIRED

The ledger sequence number to start fetching transactions from

pagination

object

The pagination object which contains the following fields:

cursor

string

When provided it excludes the element with an ID matching the cursor and only includes elements appearing after it in the response

limit

integer

The maximum number of records returned. By default, it is set to 100

xdrFormat

string

Specifies whether XDR should be encoded as Base64 (default or 'base64') or JSON ('json')

Returns

result

object

The result object containing transaction details and ledger metadata. Returns null if the block is not found

transactions

array

An array of transaction objects returned in the response

status

string

Indicates whether the transaction was successful or not

txHash

string

The unique hash of the transaction

applicationOrder

integer

The 1-based index of the transaction among all transactions included in the ledger

feeBump

boolean

Indicates whether the transaction was fee bumped

envelopeXdr

string

The TransactionEnvelope structure for this transaction (base64-encoded string)

resultXdr

string

The TransactionResult structure for this transaction (base64-encoded string)

resultMetaXdr

string

The metadata structure for this transaction (base64-encoded string)

diagnosticEventsXdr

array

(Optional) A base64-encoded slice of xdr.DiagnosticEvent. Only present if ENABLE_SOROBAN_DIAGNOSTIC_EVENTS is enabled on the RPC server

events

object

(Optional) Contains all events emitted during transaction execution. Available only on RPC v23.x (currently testnet only)

transactionEventsXdr

array[string]

(Optional) An array of base64-encoded xdr.TransactionEvent, including events such as fees being charged or refunded

contractEventsXdr

array[array]

(Optional) A nested array of base64-encoded xdr.ContractEvent. Each inner array represents the contract events emitted by a single operation within the transaction

ledger

integer

The sequence number of the ledger that included the transaction

createdAt

integer

The Unix timestamp of when the transaction was included in the ledger

latestLedger

integer

The sequence number of the latest ledger known to Stellar RPC at the time it handled the request

latestLedgerCloseTimestamp

integer

The Unix timestamp of the close time of the latest ledger known to Stellar RPC at the time it handled the request

oldestLedger

integer

The sequence number of the oldest ledger ingested by Stellar RPC at the time it handled the request

oldestLedgerCloseTimestamp

integer

The Unix timestamp of the close time of the oldest ledger ingested by Stellar RPC at the time it handled the request

cursor

string

A pagination token that can be included in a subsequent request to fetch the next page of results

Request

curl --location 'https://docs-demo.stellar-mainnet.quiknode.pro/' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 8675309,
    "method": "getTransactions",
    "params": {
        "startLedger": 58450248,
        "pagination": {
            "limit": 10
        }
    }
}'

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getTransactions",
  "params": {
    "startLedger": "58450248",
    "pagination": {
      "limit": 10
    }
  }
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.stellar-mainnet.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.stellar-mainnet.quiknode.pro/"

payload = json.dumps({
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getTransactions",
  "params": {
    "startLedger": "58450248",
    "pagination": {
      "limit": 10
    }
  }
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getTransactions",
  "params": {
    "startLedger": 58450248,
    "pagination": {
      "limit": 10
    }
  }
})

response = https.request(request)
puts response.read_body

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free