# Arweave Network & Permanent Storage API
> The Arweave permaweb — the pay-once-store-forever blockchain — live from the public Arweave gateway, no key, nothing cached. On Arweave you pay a single up-front fee and your data is stored permanently; this is the first Arweave reader in the marketplace. Quote the permanent storage cost for any data size — in winston, AR and US dollars — so apps can show "store this forever for $X" for anything from a 1 KB record to a 1 TB archive (AR/USD priced live). Read the live network info: the weave height, total block count, the number of connected peers and the running node version. And look up any block by height for its independent hash, previous block, timestamp, transaction count and the miner reward pool (in AR). The storage-and-network layer for Arweave wallets, permaweb apps, archivers and analytics. Live from arweave.net.

## 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/arweave-api/..."
```

## Pricing
- **Free** (Free) — 7,450 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 134,500 calls/Mo, 9 req/s
- **Pro** ($32/Mo) — 810,000 calls/Mo, 22 req/s
- **Business** ($89/Mo) — 5,250,000 calls/Mo, 55 req/s

## Endpoints

### Network

#### `GET /v1/block` — A block by height: hash, timestamp, tx count, reward pool

**Parameters:**
- `height` (query, optional, string) — Block height (omit for the current tip) Example: `1938430`

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

**Response:**
```json
{
    "data": {
        "note": "An Arweave block by height: its independent hash, previous block, timestamp, transaction count, the miner reward pool (in AR) and the weave size. Omit height for the current tip block.",
        "miner": "DKx8gTUSInnXbnpaAb_nfvRlYva_Lts7pmDpjTwfRMs",
        "height": 1938430,
        "source": "Arweave gateway",
        "tx_count": 6,
        "timestamp": 1781426341,
        "block_size": 1572864,
        "indep_hash": "WYzszhn4Ve6YN9JSachqUCJmzBniMeE-vFX2XMuLHxUKqNvlbUlB12QLhSYgiHag",
        "weave_size": 388289100554486,
        "previous_block": "PBJw4xXF37XzO2iUx-acHjh313A0pcTf1ZWG8anFPj3Y9K6vEE2EEBp1iFEAL9Jz",
        "reward_pool_ar": 335632.76091313,
        "reward_pool_winston": "335632760913125483"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:34.718Z",
        "request_id": "cc86a589-ed83-4d40-ac50-b44a4ced3197"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

#### `GET /v1/info` — Live network status: weave height, block count, peers, node version

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

**Response:**
```json
{
    "data": {
        "note": "Live Arweave network status: the weave height, total block count, number of connected peers and the node software version. height is the tip of the permaweb.",
        "peers": 298,
        "blocks": 1938671,
        "height": 1938670,
        "source": "Arweave gateway",
        "network": "arweave.N.1",
        "release": 92,
        "version": 5,
        "queue_length": 0,
        "current_block": "aGP7CFK3UmS3R1I1sxhz2pfffGB9Tky7aYHBwy2ouSEYxUm5JCDxYGH8qsi7TeeD",
        "node_state_latency": 1
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:34.845Z",
        "request_id": "07cf0e10-0a81-4208-b0b9-e98d323bef55"
    },
    "status": "ok",
    "message": "Info retrieved successfully",
    "success": true
}
```

### Storage

#### `GET /v1/price` — Permanent storage cost for N bytes, in winston / AR / USD

**Parameters:**
- `bytes` (query, optional, string) — Data size in bytes (default 1 MiB) Example: `1073741824`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/arweave-api/v1/price?bytes=1073741824"
```

**Response:**
```json
{
    "data": {
        "mib": 1024,
        "note": "The one-time permanent-storage cost to store this many bytes on Arweave, in winston (1 AR = 10^12 winston), AR and US dollars. Pay once, stored forever. Pass bytes for any data size (default 1 MiB).",
        "bytes": 1073741824,
        "source": "Arweave gateway",
        "cost_ar": 10.48593911,
        "cost_usd": 20.762159,
        "ar_usd_price": 1.98,
        "cost_winston": "10485939107134"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:35.077Z",
        "request_id": "66aaf97a-549f-4265-a4af-0c6b5f90e422"
    },
    "status": "ok",
    "message": "Price retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "peers": 298,
            "height": 1938670
        },
        "source": "public Arweave gateway (arweave.net), keyless",
        "service": "arweave-api",
        "endpoints": {
            "GET /v1/info": "Live network status: weave height, block count, peers, node version.",
            "GET /v1/meta": "This document.",
            "GET /v1/block": "A block by height: hash, timestamp, tx count, reward pool (height; omit for tip).",
            "GET /v1/price": "Permanent storage cost for N bytes, in winston / AR / USD (bytes; default 1 MiB)."
        },
        "description": "Read the Arweave permaweb live from the public gateway: quote the permanent (pay-once-store-forever) storage cost for any data size in winston, AR and USD; read live network info (weave height, blocks, peers, version); and look up any block by height with its hash, timestamp, transaction count and reward pool. The storage-and-network layer for Arweave wallets, permaweb apps and archivers. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:35.174Z",
        "request_id": "79c41d39-1543-4fdd-a39f-ee749b38384e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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