# Sui Network & Epoch API > Read Sui's network state live from a public Sui fullnode JSON-RPC endpoint — no key. Sui is a high-throughput, object-centric Move Layer 1; its ledger advances in checkpoints (its block equivalent) and reconfigures each epoch. The Sui on-chain reader resolves owned objects and the validator reader surfaces the validator set, but neither exposes the latest checkpoint, the epoch-level network economics, or a coin type's metadata. This opens that. Read the latest checkpoint with its epoch, sequence number, digest, lifetime network transaction count and rolling gas-cost summary (computation and storage costs in SUI); read the current epoch's economics — reference gas price, total stake in SUI, active validator count, storage-fund balances and protocol version; and resolve any Move coin type (e.g. 0x2::sui::SUI) to its on-chain metadata — decimals, name, symbol, description and icon. The network / epoch / coin-metadata layer for Sui explorers, wallets, fee estimators and analytics. Distinct from the Sui on-chain object reader, the validator reader and the Move-module reader. Live from RPC; short cache only. ## 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/suinetwork-api/..." ``` ## Pricing - **Free** (Free) — 8,500 calls/Mo, 3 req/s - **Starter** ($9/Mo) — 160,000 calls/Mo, 10 req/s - **Pro** ($30/Mo) — 840,000 calls/Mo, 25 req/s - **Scale** ($85/Mo) — 5,300,000 calls/Mo, 60 req/s ## Endpoints ### Checkpoint #### `GET /v1/checkpoint` — The latest Sui checkpoint **Parameters:** - `seq` (query, optional, string) — Checkpoint sequence number; omit for the latest Example: `286885810` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/suinetwork-api/v1/checkpoint?seq=286885810" ``` **Response:** ```json { "data": { "note": "The latest Sui checkpoint (Sui's block equivalent) — its sequence number, epoch, digest, timestamp, the lifetime network transaction count and the rolling gas-cost summary for the epoch (computation and storage costs in SUI). Pass seq for a specific checkpoint, or omit for the latest.", "epoch": 1158, "digest": "2iqHMDdQdR21Vwech6Gayez6e5Cv9ngoJbSzThZjpieg", "source": "Sui RPC", "timestamp_ms": 1781437499575, "sequence_number": 286885810, "gas_cost_summary": { "storage_cost_sui": 49909.5930036, "storage_rebate_sui": 49313.990577852, "computation_cost_sui": 634.174002119 }, "network_total_transactions": 5354360370, "transactions_in_checkpoint": 6 }, "meta": { "timestamp": "2026-06-14T17:03:46.781Z", "request_id": "feee1ea2-8cd1-4f15-a41f-82dd82ff77bf" }, "status": "ok", "message": "Checkpoint retrieved successfully", "success": true } ``` ### Epoch #### `GET /v1/epoch` — Current epoch economics **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/suinetwork-api/v1/epoch" ``` **Response:** ```json { "data": { "note": "The current Sui epoch's network economics from the system state — the epoch number, protocol version, reference gas price, total stake (in SUI), active validator count, storage-fund balances and epoch timing. The network-economics view that complements the validator-set reader. ", "epoch": 1158, "source": "Sui RPC", "safe_mode": false, "total_stake_sui": 7227128568.64594, "protocol_version": 124, "epoch_duration_ms": 86400000, "reference_gas_price": 100, "system_state_version": 2, "active_validator_count": 129, "epoch_start_timestamp_ms": 1781395521723, "pending_active_validator_count": 0, "storage_fund_total_rebates_sui": 1447745.1506632, "storage_fund_non_refundable_sui": 1170305.190593774 }, "meta": { "timestamp": "2026-06-14T17:03:47.155Z", "request_id": "847893b2-81cd-47cd-a4dd-433d2adf152c" }, "status": "ok", "message": "Epoch retrieved successfully", "success": true } ``` ### Coin #### `GET /v1/coin` — A coin type's on-chain metadata **Parameters:** - `coin_type` (query, optional, string) — Sui coin type; omit for native SUI Example: `0x2::sui::SUI` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/suinetwork-api/v1/coin?coin_type=0x2%3A%3Asui%3A%3ASUI" ``` **Response:** ```json { "data": { "name": "Sui", "note": "On-chain metadata for a Sui coin type — its name, symbol, decimals, description and icon. Every Sui coin is a typed Move object (e.g. 0x2::sui::SUI); pass coin_type for any coin, or omit for native SUI.", "source": "Sui RPC", "symbol": "SUI", "decimals": 9, "icon_url": null, "coin_type": "0x2::sui::SUI", "description": null, "metadata_object_id": "0xf256d3fb6a50eaa748d94335b34f2982fbc3b63ceec78cafaa29ebc9ebaf2bbc" }, "meta": { "timestamp": "2026-06-14T17:03:47.377Z", "request_id": "bc4737b3-bf56-494c-acec-f5a876f0a2e8" }, "status": "ok", "message": "Coin metadata retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/suinetwork-api/v1/meta" ``` **Response:** ```json { "data": { "sample": { "epoch": 1158, "gas_price": 100 }, "source": "public Sui fullnode JSON-RPC (fullnode.mainnet.sui.io), keyless", "service": "suinetwork-api", "endpoints": { "GET /v1/coin": "A coin type's metadata: decimals, name, symbol, icon (coin_type; omit for SUI).", "GET /v1/meta": "This document.", "GET /v1/epoch": "Current epoch economics: gas price, total stake, storage fund, protocol version.", "GET /v1/checkpoint": "The latest checkpoint: epoch, digest, tx count, gas summary (seq optional)." }, "description": "Read Sui's network state live from a public Sui fullnode JSON-RPC: read the latest checkpoint (epoch, digest, network tx count, gas-cost summary), read the current epoch's economics (reference gas price, total stake, storage fund, protocol version), and resolve any coin type's metadata (decimals, name, symbol, icon). The network / epoch / coin-metadata layer for Sui explorers, wallets and analytics. Live, short cache only.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-14T17:03:47.448Z", "request_id": "68ea5d12-87e0-41fa-bd95-4a08d0874bfa" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/suinetwork-api OpenAPI spec: https://www.oanor.com/api/suinetwork-api/openapi.json