{"openapi":"3.1.0","info":{"title":"Sui Network & Epoch API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/suinetwork-api","description":"oanor gateway"}],"tags":[{"name":"Checkpoint"},{"name":"Epoch"},{"name":"Coin"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/checkpoint":{"get":{"operationId":"get_v1_checkpoint","tags":["Checkpoint"],"summary":"The latest Sui checkpoint","description":"","parameters":[{"name":"seq","in":"query","required":false,"description":"Checkpoint sequence number; omit for the latest","schema":{"type":"string"},"example":"286885810"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/epoch":{"get":{"operationId":"get_v1_epoch","tags":["Epoch"],"summary":"Current epoch economics","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/coin":{"get":{"operationId":"get_v1_coin","tags":["Coin"],"summary":"A coin type's on-chain metadata","description":"","parameters":[{"name":"coin_type","in":"query","required":false,"description":"Sui coin type; omit for native SUI","schema":{"type":"string"},"example":"0x2::sui::SUI"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"coin_type":"0x2::sui::SUI","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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":890,"monthly_call_quota":160000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2980,"monthly_call_quota":840000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8450,"monthly_call_quota":5300000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/suinetwork-api"}