Monero(XMR)

GetBlock provides fast and reliable access to Monero nodes via JSON-RPC API. Connect to the Monero network without running your own infrastructure.

Monero (XMR) is the leading privacy-focused cryptocurrency by market capitalization and a foundational implementation of the CryptoNote protocol. Originally proposed in 2013 by Nicolas van Saberhagen. It launched in 2014, Monero uses ring signatures, stealth addresses, and RingCT (Ring Confidential Transactions) to make transactions untraceable on public block explorers — a property that distinguishes it from transparent ledgers like Bitcoin and Ethereum. The network is secured by the ASIC-resistant RandomX Proof-of-Work algorithm, which keeps mining accessible to commodity CPU hardware and counters centralization pressure. Monero is the canonical choice for use cases that require fungibility and on-chain confidentiality.

Key Features

• Ring Signatures: Sender identity is obfuscated by mixing the real signer with decoy outputs drawn from prior transactions on the chain

• Stealth Addresses: Each transaction generates a unique one-time recipient address, hiding which wallet ultimately receives the funds

• RingCT (Ring Confidential Transactions): Transaction amounts are cryptographically hidden — only sender and recipient know how much XMR moved

• RandomX Proof-of-Work: CPU-friendly, ASIC-resistant mining algorithm that preserves decentralization

• Atomic Units: 1 XMR = 10¹² atomic units (12 decimals) — the smallest unit in monerod's accounting

• Bulletproofs: Zero-knowledge range proofs that drastically reduce transaction size while preserving privacy

• Dynamic Block Size: Blocks scale up under load and shrink under quiet periods, smoothing fee volatility

• Tail Emission: Fixed 0.6 XMR per block emission after the main supply schedule, ensuring perpetual miner incentives

• Adaptive Hard Forks: Network-wide upgrades every ~6 months keep the protocol responsive to cryptographic research

• Tor and I2P Support: First-class integration with anonymity networks at the node and wallet layer

TECHNICAL DISCLAIMER: AUTHORITATIVE MONEROD RPC SPECIFICATION

GetBlock’s Monero API reference documentation is provided exclusively for informational purposes and to optimize the developer experience. The canonical and normative specification for the monerod daemon RPC interface is maintained by the Monero Project and published at docs.getmonero.org with the upstream source at github.com/monero-project/monero-docs. For protocol-level details, transaction structure, and cryptographic primitives, consult the official Monero documentation at getmonero.org.

Network Information

Property	Value
Network Name	Monero Mainnet
Native Currency	Monero (XMR)
Decimals	12 (1 XMR = 10¹² atomic units)
Block Time	~2 minutes (120 seconds target)
Consensus	Proof-of-Work (RandomX algorithm)
Privacy Primitives	Ring signatures, stealth addresses, RingCT, Bulletproofs
Address Format	Base58 — standard (4… / 8…), subaddress (8…), integrated (4… with payment ID)
Block Explorer	xmrchain.net, exploremonero.com

Base URL

Frankfurt, Germany

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

Monero is only accessible via a dedicated node

Supported Networks

Network	JSON-RPC	HTTP Endpoints	Frankfurt, Germany
Mainnet	✅	✅	✅

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).

JavaScript (Axios)

1

Setup project

Create and initialize a new project:

mkdir monero-api-quickstart
cd monero-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": "get_block_count",
    "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 GetBlock access token.

6

Run the script

node index.js

Expected output (example):

{
    "id": "getblock.io",
    "jsonrpc": "2.0",
    "result": {
        "count": 3194582,
        "status": "OK",
        "untrusted": false
    }
}

The count field is the current height of the Monero blockchain.

Python (Requests)

1

Setup the project directory

mkdir monero-api-quickstart
cd monero-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": "get_block_count",
    "params": {},
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.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

Available API Methods

Monero exposes two parallel surfaces: standard JSON-RPC methods (the majority) and non-JSON-RPC HTTP endpoints for binary and high-performance operations. GetBlock provides access to both.

JSON-RPC: Blocks & Chain

Method	Description
get_block_count	Returns the current height of the longest chain
on_get_block_hash	Returns the block hash at a given height
get_block_template	Returns a block template for mining
submit_block	Submits a mined block to the network
get_last_block_header	Returns the header of the most recent block
get_block_header_by_hash	Returns a block header by its hash
get_block_header_by_height	Returns a block header by height
get_block_headers_range	Returns headers for a range of blocks
get_block	Returns full block information by height or hash
get_alternate_chains	Returns information about known alternative chains
get_fee_estimate	Returns the current fee estimate for transactions
get_coinbase_tx_sum	Returns the cumulative coinbase transaction sum over a block range

JSON-RPC: Node Info & Network

Method	Description
get_info	Returns general information about the node and network state
get_version	Returns the version of the connected monerod instance
hard_fork_info	Returns information about the current and upcoming hard forks
sync_info	Returns information about node synchronization status
get_connections	Returns the list of P2P connections of the node
get_output_histogram	Returns a histogram of RingCT outputs by amount

JSON-RPC: Transaction Pool

Method	Description
get_txpool_backlog	Returns the current transaction pool backlog
relay_tx	Relays one or more transactions already in the pool to peers
flush_txpool	Removes transactions from the pool {disallowed}

JSON-RPC: Bans & Administration

Method	Description
get_bans	Returns the list of banned IPs {disallowed}
set_bans	Bans one or more IPs {disallowed}
banned	Checks whether a given IP is banned

Non-JSON-RPC HTTP Endpoints

These endpoints do not use the JSON-RPC envelope — they take a plain JSON body posted to their dedicated path.

Endpoint	Description
/get_height	Returns the current node height (lightweight)
/get_transactions	Returns one or more transactions by hash
/get_alt_blocks_hashes	Returns hashes of known alternative-chain blocks
/is_key_image_spent	Checks whether one or more key images have been spent
/send_raw_transaction	Broadcasts a serialized signed transaction to the network
/get_outs	Returns transaction outputs by index
/get_limit	Returns current peer-to-peer bandwidth limits
/get_net_stats	Returns network statistics for the node
/get_peer_list	Returns the node's known peer list
/get_public_nodes	Returns the list of advertised public peer nodes

Support

For technical support and questions:

• Support Email: [e-mail]

See Also

• Official Monero Documentation

• Monero Docs — monerod RPC Reference

• Monero Project on GitHub

• Monero Block Explorer (xmrchain)

• monero-python (Python SDK)

• monero-javascript (JavaScript SDK)

• Monero StackExchange