XRP Ledger

GetBlock provides fast and reliable access to XRP Ledger nodes via JSON-RPC and WebSocket APIs. Connect to the XRP Ledger network without running your own infrastructure.

XRP Ledger (XRPL) is a decentralized, open-source blockchain launched in 2012. Unlike Bitcoin or Ethereum, XRPL uses a unique Federated Consensus mechanism that enables fast, low-cost transactions without mining. The network processes over 1,500 transactions per second with settlement times of 3-5 seconds, making it ideal for payments, tokenization, and DeFi applications.

Key Features

• Federated Consensus Protocol: Unique consensus mechanism using trusted validators (Unique Node Lists) instead of Proof of Work or Proof of Stake

• Fast Settlement: Transactions finalize in 3-5 seconds

• High Throughput: Supports 1,500+ transactions per second

• Low Transaction Fees: Fees are typically less than $0.01 per transaction

• Native DEX: Built-in decentralized exchange for trading any issued tokens

• Energy Efficient: Minimal energy consumption compared to PoW blockchains

• XRP Native Token: Used for transaction fees, bridging currencies, and as a store of value

• Token Issuance: Native support for issuing custom tokens and stablecoins

• NFT Support: XLS-20 standard for minting, trading, and burning NFTs

• No Smart Contracts by Default: Purpose-built for payments; EVM sidechain available for smart contract functionality

TECHNICAL DISCLAIMER The canonical specification for XRP Ledger API methods is maintained in the official XRPL documentation at xrpl.org.

Network Configuration

Property	Value
Network Name	XRP Ledger
Native Token	XRP
Decimals	6 (1 XRP = 1,000,000 drops)
Ledger Close Time	~3-5 seconds
Account Reserve	10 XRP base reserve
Block Explorer	https://xrpscan.com

Base URL

Frankfurt, Germany

https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

Supported Networks

Network	Chain ID	JSON-RPC	WSS
Mainnet	1600	✅	✅

Quickstart

In this section, you will learn how to make your first call with either:

• Axios (JavaScript/Node.js)

• Python (Requests library)

Before you begin, you must have already installed npm or yarn on your local machine (for the Axios example) or Python and pip (for the Python example).

Refer to:

• npm installation guide

• yarn installation guide

Javascript(Axios)

1

Setup project

Create and initialize a new project:

mkdir xrpl-api-quickstart
cd xrpl-api-quickstart
npm init --yes

2

Install Axios

npm install axios

3

Create file

Create a new file named index.js. This is where you will make your first call.

4

Set ES module type

Set the ES module "type": "module" in your package.json.

5

Add code

Add the following code to index.js:

index.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "server_info",
    "params": [{}],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.eu-central-1.getblock.io/<ACCESS_TOKEN>',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

6

Run the script

node index.js

Expected output (example):

{
    "result": {
        "info": {
            "build_version": "3.1.0",
            "complete_ledgers": "100807399-101925334",
            "hostid": "OVA",
            "initial_sync_duration_us": "714094236",
            "io_latency_ms": 1,
            "jq_trans_overflow": "0",
            "last_close": {
                "converge_time_s": 3.002,
                "proposers": 34
            },
            "load_factor": 1,
            "network_id": 0,
            "peer_disconnects": "5975",
            "peer_disconnects_resources": "0",
            "peers": 131,
            "ports": [
                {
                    "port": "5005",
                    "protocol": [
                        "http"
                    ]
                },
                {
                    "port": "80",
                    "protocol": [
                        "ws"
                    ]
                },
                {
                    "port": "2459",
                    "protocol": [
                        "peer"
                    ]
                },
                {
                    "port": "50051",
                    "protocol": [
                        "grpc"
                    ]
                }
            ],
            "pubkey_node": "n9437mTpq2oNhbBqDPpibuPz11yaTAS76iQNqVTXHF13qDgXgcPB",
            "server_state": "full",
            "server_state_duration_us": "166954693311",
            "state_accounting": {
                "connected": {
                    "duration_us": "708821254",
                    "transitions": "2"
                },
                "disconnected": {
                    "duration_us": "1087525",
                    "transitions": "2"
                },
                "full": {
                    "duration_us": "166954693311",
                    "transitions": "1"
                },
                "syncing": {
                    "duration_us": "4185421",
                    "transitions": "1"
                },
                "tracking": {
                    "duration_us": "33",
                    "transitions": "1"
                }
            },
            "time": "2026-Jan-31 05:36:36.646370 UTC",
            "uptime": 167668,
            "validated_ledger": {
                "age": 4,
                "base_fee_xrp": 1e-05,
                "hash": "2AAEF99EFEDD15D293F8A1023AA873F2D7675FD6A55F5C19BC07C192EEC946B4",
                "reserve_base_xrp": 1,
                "reserve_inc_xrp": 0.2,
                "seq": 101925334
            },
            "validation_quorum": 28
        },
        "status": "success"
    }
}

Python(Request)

1

Setup the project directory

mkdir xrpl-api-quickstart
cd xrpl-api-quickstart

2

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

3

Install requests

pip install requests

4

Create script

Create a file called main.py with the following content:

main.py

import requests
import json

url = "https://shared.eu-central-1.getblock.io/<ACCESS_TOKEN>"

payload = json.dumps({
  "jsonrpc": "2.0",
  "method": "server_info",
  "params": [
    {}
  ],
  "id": "getblock.io"
})
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

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

print(response.text)

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

5

Run the script

python main.py

Supported Methods

Account Methods

Method	Description
account_info	Get account information and XRP balance
account_channels	Get payment channels where account is source
account_currencies	Get currencies an account can send/receive
account_lines	Get trust lines for an account
account_objects	Get raw ledger objects owned by account
account_offers	Get outstanding offers by account
account_tx	Get transactions for an account

Ledger Methods

Method	Description
ledger	Get ledger information
ledger_closed	Get most recently closed ledger
ledger_current	Get current working ledger
ledger_data	Get contents of specified ledger
ledger_entry	Get specific ledger entry

Transaction Methods

Method	Description
tx	Get transaction by hash
submit	Submit a signed transaction
submit_multisigned	Submit a multi-signed transaction
transaction_entry	Get transaction from specific ledger
tx_history	Get recent transactions (deprecated)

Path & Order Book Methods

Method	Description
book_offers	Get offers to exchange currencies
deposit_authorized	Check if deposit is authorized
path_find	Find payment paths
ripple_path_find	Find ripple payment paths

Payment Channel Methods

Method	Description
channel_authorize	Authorize payment channel claim
channel_verify	Verify payment channel claim signature

Subscription Methods

Method	Description
subscribe	Subscribe to events
unsubscribe	Unsubscribe from events

Server Methods

Method	Description
fee	Get current transaction fee
server_info	Get server information
server_state	Get server state
manifest	Get validator manifest
ping	Ping the server
random	Generate random number

Utility Methods

Method	Description
json	Proxy for other commands

Signing Methods (Admin)

Method	Description
sign	Sign a transaction
sign_for	Sign for multi-signature

Special Methods

Method	Description
gateway_balances	Get gateway balances
noripple_check	Check NoRipple flag status

Support

For technical support and questions:

• Support Email: [e-mail]

See Also

• XRP Ledger Developer Documentation

• XRP Ledger Block Explorer - XRPScan

• XRP Ledger Block Explorer - Bithomp

• XRPL Learning Portal

• XRP Ledger API Reference

• XRPL JavaScript Library

• XRP Ledger Testnet Faucet