Skip to main content

Ripple Blocks API helps you get information on Blocks in the network.

On the XRP Ledger, "blocks" correspond to validated ledgers—each ledger captures a snapshot of all account balances, trust lines, and offers at a specific sequence number. The blocks API returns ledger height, close time, hash, total XRP supply (totalCoins), and account-hash references. Use it for network-health dashboards, explorer backends displaying recent ledgers, and correlating transaction data to specific ledger versions.

Below are the fields in the API:

query ($network: RippleNetwork!, $from: ISO8601DateTime, $till: ISO8601DateTime) {
  ripple(network: $network) {
    blocks(
      options: {desc: "height", limit: 10, offset: 0}
      time: {since: $from, till: $till}
    ) {
      timestamp {
        time(format: "%Y-%m-%d %H:%M:%S")
      }
      height
      hash
      totalCoins
      accountHash
    }
  }
}

{
  "network": "ripple",
  "from": "2023-08-15T09:01:24.000Z",
  "till": "2023-08-15T09:31:24.000Z",
  "dateFormat": "%Y-%m-%d"
}