io.github.nowi333/monerometrics

Range of consecutive heights ending at `to` (default the current tip), listing every canonical block and any competing orphan, with fork-point flags. Use this to browse a stretch of the chain or see recent blocks; for a single block use search_block or get_block.

Evidence quality behind pool attribution over a window: share of blocks proven cryptographically by view key, claimed by a pool API, inferred from the coinbase, or unattributed, plus claims a pool could not prove with its own key and the merge-mined share. Use this to judge how far to trust pool_distribution.

Full detail of one block given its exact 64-character hash: height, previous hash, timestamp, size, difficulty, reward, coinbase, transaction hashes, merge-mining tag, mining pool and, when proven, the view-key proof inputs. Use this when you already have a block hash (e.g. from recent_orphans or chain_fork_window). If you only have a height, use search_block.

Live Haveno XMR/USD order book as price levels, both sides, each priced against centralized spot. Each level carries cumulative depth, offer count, payment methods and a reversible flag. `asks` are makers selling XMR (taking one means buying); `bids` are makers buying (taking one means selling). Offers are advertisements with differing payment methods, not a matched book, so the best bid can sit at or above the best ask. Use this to see liquidity at each price; for a single headline price use price. Takes no arguments.

Executed Haveno trades grouped by payment method (PayPal, Zelle, cash by mail...), with trade count, volume and the average, median and standard deviation of the premium over spot. Use this to compare what each payment rail costs. The premium tracks how reversible the rail is (chargeback risk), not privacy. The reversible flag is our own classification, not a Haveno field; methods with few trades give a fragile premium.

Time series of the Haveno peer-to-peer premium over centralized spot, both sides of the book, sampled every 10 minutes. Use this to see how the P2P premium moved over time; for the current value only, use price. Series carry price, amount and offer count but not the payment method (see haveno_payment_methods for that). History starts on 24 August 2026, when recording began.

Look up one transaction by its 64-character hash: in the mempool or mined, block height, confirmations, whether it is spendable yet, the pool that mined its block, and whether that height was ever contested by a reorg. Use this for any transaction-hash question. It never returns amounts, senders or recipients: the Monero protocol encrypts them.

Time series of the actual time between consecutive canonical blocks, in seconds (target 120 s), one point per block, capped at 1500 points. Use this to spot unusually slow or fast block production, e.g. around a hashrate shift or selfish-mining episode.

Time series of the average block reward in XMR per block (Monero tail emission is about 0.6 XMR plus fees). Use this to follow emission and fee income over time.

Time series of the Monero network hashrate in H/s, derived from difficulty / 120 s target, bucketed to about 300 points per window. Use this for hashrate trends; for the current value only, use network_info.

Live snapshot of the Monero network right now: node sync status, latest indexed height, difficulty, estimated hashrate and current mempool size. Use this for "what is the state of the network now". For how a metric evolved over time, use network_hashrate, network_blocktime, network_mempool or network_emission instead. Takes no arguments.

Time series of the mempool size: number of transactions waiting to be mined. Use this for congestion trends; for the current count only, use network_info. This series is observed live and cannot be rebuilt, so it starts when monitoring began.

Share of blocks mined by each pool over a window, plus the largest pool's share, the top-two combined share and the Nakamoto coefficient (fewest pools controlling over 50% of blocks). Use this to assess mining centralization. Unattributed blocks stay in the denominator but are credited to no pool, so the coefficient is an upper bound. For how each attribution was established, use chain_provenance.

Health of each mining-pool API used for block attribution: whether it is reachable and how many blocks it returned. Use this to explain a high unattributed share in pool_distribution. Takes no arguments.

Current XMR price in one call: the centralized spot (CoinGecko, Kraken fallback) and the Haveno peer-to-peer quote on both sides. Returns the best offer and the amount-weighted average on each side, resting depth, offer counts and round_trip_cost_pct, the cost of buying XMR and selling it straight back (an upper bound, usually far above the headline premium). Use this for "what does XMR cost now". For the premium history use haveno_premium; for individual price levels use haveno_book. Takes no arguments.

Orphan blocks (blocks that lost a fork race) paired with the canonical block that won at the same height, newest first. Use this to list losing blocks and which pool mined them; for whole reorg events (depth, fork point) use reorgs. The default window "all" returns the last N orphans however old.

Summary statistics of reorganizations per period (24h, 7d, 30d, 90d and everything recorded): event count, average and maximum depth, transactions affected, plus the date monitoring began. Use this for "how many reorgs and how deep"; for the individual events use reorgs. Takes no arguments.

List of individual chain reorganizations detected, most recent first: fork point height, depth in blocks, old and new chain tips, transactions displaced, detection time. Use this to inspect specific reorg events. For counts and depth summaries per period use reorg_stats; for the losing blocks themselves use recent_orphans. Takes no arguments.

Find one block from a height or a hash, anywhere from the genesis block (height 0) to the tip. Returns the same detail as get_block plus is_canonical and, for a height, any orphan blocks competing at that height. Use this when the user gives a height, or when unsure whether a value is a height or a hash. For a range of consecutive blocks use chain_fork_window.