{"openapi":"3.0.3","info":{"title":"Monad Indexer API","description":"Demo-grade today — data may be incorrect in some cases. Please bear with us.","version":"0.1.0"},"components":{"schemas":{}},"paths":{"/health":{"get":{"summary":"Health","tags":["RPC Service"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"version":{"type":"string"},"uptimeSeconds":{"type":"number"}}}}}}}}},"/network":{"get":{"summary":"Network summary","tags":["RPC Service"],"responses":{"200":{"description":"Default Response"}}}},"/miners/stats":{"get":{"summary":"Miner stats window","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"fromBlock","required":false},{"schema":{"type":"string"},"in":"query","name":"toBlock","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/blocks/recent":{"get":{"summary":"Recent blocks","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/block/{number}":{"get":{"summary":"Block header","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"number","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/tx/{hash}":{"get":{"summary":"Transaction","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"hash","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/tx/{hash}/logs":{"get":{"summary":"Tx logs","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"hash","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/tx/{hash}/receipt":{"get":{"summary":"Receipt","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"hash","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/block/{number}/full":{"get":{"summary":"Full block","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"number","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/blocks/range":{"get":{"summary":"Block range","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"from","required":true},{"schema":{"type":"string"},"in":"query","name":"to","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/block/{number}/miner-stats":{"get":{"summary":"Per-block miner stats","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"number","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/gas/price-history":{"get":{"summary":"Base fee history","tags":["RPC Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/gas/utilization-chart":{"get":{"summary":"Gas utilization","tags":["RPC Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/gas/fee-distribution":{"get":{"summary":"Fee distribution","tags":["RPC Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/block-size-trend":{"get":{"summary":"Block size trend","tags":["RPC Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/active-addresses":{"get":{"summary":"Active addresses","tags":["RPC Service"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"period","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/network/overview":{"get":{"summary":"Network overview","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/metrics/{period}":{"get":{"summary":"Aggregated metrics","tags":["Network Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"period","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/network/fee-history":{"get":{"summary":"Fee / base fee history","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/staking-activity":{"get":{"summary":"Staking activity counts","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/performance":{"get":{"summary":"Performance summary","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/live":{"get":{"summary":"Live snapshot","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/tps/chart":{"get":{"summary":"TPS chart (metrics.chain_hourly)","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/gas/chart":{"get":{"summary":"Gas chart","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/block-time/chart":{"get":{"summary":"Block time intervals","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/transaction-volume/chart":{"get":{"summary":"Tx volume","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/miners/top":{"get":{"summary":"Top miners","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/miners/distribution":{"get":{"summary":"Miner distribution","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/miners/hashrate-estimate":{"get":{"summary":"Hashrate estimate","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/contracts/most-active":{"get":{"summary":"Most active contracts","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/contracts/gas-consumption":{"get":{"summary":"Gas by contract","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/contracts/transaction-types":{"get":{"summary":"Tx types distribution","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/staking/delegation-trend":{"get":{"summary":"Delegation trend","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/staking/validator-rotations":{"get":{"summary":"Validator rotations","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/network/staking/rewards-distribution":{"get":{"summary":"Rewards distribution","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/validators":{"get":{"summary":"Validators list","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/committees/{type}/{epoch}":{"get":{"summary":"Committee by type and epoch","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"type","required":true},{"schema":{"type":"string"},"in":"path","name":"epoch","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/committees/epochs":{"get":{"summary":"Known staking epochs (committee)","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/{id}/profile":{"get":{"summary":"Validator profile","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/{id}/performance-history":{"get":{"summary":"Performance history","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/{id}/uptime-chart":{"get":{"summary":"Uptime chart","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/rankings/performance":{"get":{"summary":"Rankings performance","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/rankings/uptime":{"get":{"summary":"Rankings uptime","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/rankings/stake":{"get":{"summary":"Rankings stake","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/committees/current/composition":{"get":{"summary":"Current committee composition","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/committees/rotation-frequency":{"get":{"summary":"Rotation frequency","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/committees/performance-comparison":{"get":{"summary":"Performance comparison","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/{id}/delegators/count":{"get":{"summary":"Delegators count","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/{id}/stake-distribution":{"get":{"summary":"Stake distribution","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/{id}/rewards-history":{"get":{"summary":"Rewards history","tags":["Validators Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/system/overview":{"get":{"summary":"System overview","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/system/performance":{"get":{"summary":"App performance","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/system/resources":{"get":{"summary":"Host resources","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/indexing/progress":{"get":{"summary":"Indexing progress","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/indexing/speed-chart":{"get":{"summary":"Indexing speed chart","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/indexing/ingest-gaps":{"get":{"summary":"indexer.ingest_gaps queue (skipped RPC ingest ranges)","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/indexing/backlog":{"get":{"summary":"Backlog / gaps","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/data/summary":{"get":{"summary":"Data summary","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/data/growth-chart":{"get":{"summary":"DB growth chart","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/data/cleanup-status":{"get":{"summary":"Cleanup / retention","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/overview":{"get":{"summary":"Short overview: ingest cursors and latest samples","tags":["Hightower's Monad WS Gateway"],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/cursor":{"get":{"summary":"Reconnect cursors (`resume_from`) per ingest source","tags":["Hightower's Monad WS Gateway"],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/lifecycle/events":{"get":{"summary":"block_lifecycle_events (newest first; cursor = row id, next page uses lower id)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"event_name","required":false},{"schema":{"type":"string"},"in":"query","name":"from_block","required":false},{"schema":{"type":"string"},"in":"query","name":"to_block","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/blocks/{blockNumber}/consensus-meta":{"get":{"summary":"BlockStart consensus fields (block_consensus_meta)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"blockNumber","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/blocks/{blockNumber}/coverage":{"get":{"summary":"RPC vs WS completeness flags (block_ingest_coverage)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"blockNumber","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/blocks/{blockNumber}/block-end":{"get":{"summary":"BlockEnd metadata (block_end_meta)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"blockNumber","required":true}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/epochs/bounds":{"get":{"summary":"Block ranges per consensus_epoch","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"epoch","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/epochs/rpc-snapshots":{"get":{"summary":"eth_call snapshot state per epoch (rpc_epoch_snapshot_state)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"kind","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/tps":{"get":{"summary":"TPS samples (tps_samples)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/contention":{"get":{"summary":"Contention samples (contention_samples)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/metrics":{"get":{"summary":"gateway_metric_samples stream","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false},{"schema":{"type":"string"},"in":"query","name":"metric_name","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/rest-status":{"get":{"summary":"GET /v1/status snapshots (rest_status_samples)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/hello":{"get":{"summary":"Gateway Hello log (gateway_hello_log)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/top-accesses":{"get":{"summary":"TopAccesses (top_accesses_samples)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/samples/lifecycle-stages":{"get":{"summary":"Proposed→… stage transitions (lifecycle_stage_samples)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"hours","required":false},{"schema":{"type":"string"},"in":"query","name":"to_stage","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/gateway/staking-txn-logs":{"get":{"summary":"Staking TxnLog rows from gateway (staking_txn_logs)","tags":["Hightower's Monad WS Gateway"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string"},"in":"query","name":"from_block","required":false},{"schema":{"type":"string"},"in":"query","name":"to_block","required":false}],"responses":{"200":{"description":"Default Response"}}}},"/api/network/health":{"get":{"summary":"Health","tags":["Network Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/validators/health":{"get":{"summary":"Health","tags":["Validators Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/system/health":{"get":{"summary":"Health","tags":["Orchestrator Service"],"responses":{"200":{"description":"Default Response"}}}},"/api/chat":{"post":{"summary":"AI assistant (Gemini + indexer API tools)","tags":["Orchestrator Service"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"prompt":{"type":"string"}}}}}},"responses":{"200":{"description":"Default Response"}}}},"/api/logs/{type}":{"get":{"summary":"Logs: `indexer` (file tail) or `api` (monad-api pino buffer)","tags":["Orchestrator Service"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"type","required":true}],"responses":{"200":{"description":"Default Response"}}}}},"servers":[{"url":"https://mcp-monad.com"}],"tags":[{"name":"RPC Service","description":"Blocks, transactions, gas"},{"name":"Network Service","description":"Metrics and charts"},{"name":"Validators Service","description":"Validators and committees"},{"name":"Orchestrator Service","description":"System and indexing"},{"name":"Hightower's Monad WS Gateway","description":"Execution Events Gateway ingest (`monad_exec` schema)"}]}