# Monero Network API
> Live network and blockchain data from Monero (XMR), the leading privacy cryptocurrency — no key, nothing stored. The network endpoint returns the live chain state: block height, difficulty, an estimated network hashrate, the mempool size, peer connections, hard-fork version and median block size. The block endpoint returns a block by height — its hash, size, timestamp and transaction count. The mempool endpoint returns the current unconfirmed-transaction pool with a sample of pending transactions and their fees. Data comes live from a public Monero blockchain-explorer node. Monero is privacy-preserving, so individual balances and amounts are unobservable — this is network/aggregate data, distinct from the exchange-ticker, market and transparent-chain APIs in the catalogue. Built for Monero dashboards, network monitors, mining tooling and explorers.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/monero-api/..."
```

## Pricing
- **Free** (Free) — 19,800 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 262,000 calls/Mo, 10 req/s
- **Growth** ($25/Mo) — 1,215,000 calls/Mo, 25 req/s
- **Scale** ($58/Mo) — 4,340,000 calls/Mo, 50 req/s

## Endpoints

### Block

#### `GET /v1/block` — Block by height — hash, size, timestamp, tx count

**Parameters:**
- `height` (query, required, string) — Block height Example: `3000000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/monero-api/v1/block?height=3000000"
```

**Response:**
```json
{
    "data": {
        "hash": "d29c51c4354a396f370335035540fc94372bd277c2f65b50cc5bd2608a92c69c",
        "height": 3000000,
        "source": "xmrchain",
        "tx_count": 38,
        "timestamp": "2023-10-20T14:49:02.000Z",
        "size_bytes": 100297,
        "current_height": 3694084
    },
    "meta": {
        "timestamp": "2026-06-11T16:47:00.844Z",
        "request_id": "f1f5c89b-3d16-4cfe-b904-41cfb1d4c96a"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Network

#### `GET /v1/network` — Live Monero chain state

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/monero-api/v1/network"
```

**Response:**
```json
{
    "data": {
        "chain": "Monero",
        "height": 3694084,
        "source": "xmrchain",
        "difficulty": 681205290758,
        "hashrate_hs": 5676710756.32,
        "connections_in": 32,
        "top_block_hash": "334286dbd45682c16b9f7cd53d42be0641cd098b887f8e41685eba01d4d8a306",
        "tx_count_total": 61241471,
        "connections_out": 32,
        "block_size_limit": 626844,
        "hardfork_version": 16,
        "mempool_tx_count": 549,
        "block_size_median": 313422,
        "block_time_target_s": 120
    },
    "meta": {
        "timestamp": "2026-06-11T16:47:01.082Z",
        "request_id": "6f3e616e-98df-47de-9f8e-a28e89f32f78"
    },
    "status": "ok",
    "message": "Network retrieved successfully",
    "success": true
}
```

### Mempool

#### `GET /v1/mempool` — Current unconfirmed-transaction pool with a sample

**Parameters:**
- `limit` (query, optional, string) — Sample size (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/monero-api/v1/mempool?limit=10"
```

**Response:**
```json
{
    "data": {
        "sample": [
            {
                "fee_xmr": 0.00017712,
                "tx_hash": "f5736b2d75a8ba3aaabb71738ce665d669057627893878d3b9c7ff703b3496d0",
                "timestamp": "2026-06-11T16:46:54.000Z",
                "fee_atomic": 177120000,
                "size_bytes": 2214
            },
            {
                "fee_xmr": 0.00012296,
                "tx_hash": "286d5a0f39b40f07bda31120012b99d2959c443f28b4ac6a157681646c9d3219",
                "timestamp": "2026-06-11T16:46:54.000Z",
                "fee_atomic": 122960000,
                "size_bytes": 1537
            },
            {
                "fee_xmr": 0.00012264,
                "tx_hash": "558b16642a9b0f920b22752a44970c837b0f0c6b1f5e94d06e6ad244da1fc714",
                "timestamp": "2026-06-11T16:46:49.000Z",
                "fee_atomic": 122640000,
                "size_bytes": 1533
            },
            {
                "fee_xmr": 0.00012248,
                "tx_hash": "e787f6c4bd55229f0f51e06d144f5f7e35d57b49d658bbc4d2e5cf48e77c722c",
                "timestamp": "2026-06-11T16:46:48.000Z",
                "fee_atomic": 122480000,
                "size_bytes": 1531
            },
            {
                "fee_xmr": 0.00017808,
                "tx_hash": "4bc644023a5c2aa0d3ece3e8b3fc1f157d1c33df52267b741612a2f1b92455e6",
                "timestamp": "2026-06-11T16:46:38.000Z",
                "fee_atomic": 178080000,
                "size_bytes": 2226
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/monero-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "The network hashrate is estimated as difficulty divided by the block-time target (~120s). Monero is privacy-preserving, so per-address balances and amounts are not available — this is network/aggregate data.",
        "height": 3694084,
        "source": "Public Monero explorer (xmrchain.net/api, live)",
        "service": "monero-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Block by height — hash, size, timestamp, tx count (height=3000000).",
            "GET /v1/mempool": "Current unconfirmed-transaction pool with a sample (limit=10, max 50).",
            "GET /v1/network": "Live Monero chain state — height, difficulty, hashrate, mempool, peers."
        },
        "description": "Live network and blockchain data from Monero (XMR), the leading privacy cryptocurrency. The network endpoint returns the live chain state (block height, difficulty, estimated hashrate, mempool size, peer connections, hard-fork version, median block size); the block endpoint returns a block by height (hash, size, timestamp, transaction count); the mempool endpoint returns the current unconfirmed-transaction pool with a sample of pending transactions. Live, no key, nothing stored. Network-level data for a privacy chain whose individual balances and transactions are unobservable — distinct from the exchange-ticker, market and transparent-chain APIs.",
        "upstream_status": "ok"
    },
    "meta"
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/monero-api
OpenAPI spec: https://www.oanor.com/api/monero-api/openapi.json