Skip to main content

The addressstats field allows us to retrieves statistics related to blockchain addresses.

Address statistics provide aggregate metrics for an XRP Ledger account: transaction counts, sent and received amounts across XRP and issued currencies, fee totals, and active-day counts. These summaries are useful for compliance profiling, payment corridor analysis, and building explorer-style account pages without scanning every ledger entry.

Here is an example that demonstrates how to retrieve statistics about the USDT smart contract:

{
  ripple {
    addressStats(address: {is: "rUTEn2jLLv4ESmrUqQmhZfEfDN3LorhgvZ"}) {
      address {
        balance
        daysWithReceived
        daysWithSent
        daysWithTransactions
        daysWithTransfers
        receiveAmount
        receiveFromCurrencies
        receiveTxCount
        receiveFromCount
        sendAmount
        sendToCount
        sendToCurrencies
        sendTxCount
      }
    }
  }
}
Filtering Address Stats
  • address: Filter by a specific address or a list of addresses
  • options: Filter returned data by ordering, limiting, and constraining it. Available fields: asc, ascByInteger, desc, descByInteger, limit, limitBy, offset.
  • address: Returns statistics for the blockchain address