{"uid":"cap_z7uRgTEeZkVYa2ft-vjmi","slug":"diamond-bitcoin-block-stats-b28b35b9","name":"Diamond Bitcoin Block Stats","description":"Statistics for one recent Bitcoin block (this pruned node keeps roughly the last 10,000) by height or hash: tx count, total fees, fee-rate percentiles, size, weight, subsidy, inputs and outputs, SegWit share, and the miner (coinbase tag and pool).","url":"https://diamond.btc-intel.workers.dev/api/x402/block_stats?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["block_id"],"properties":{"block_id":{"type":"string","maxLength":64,"description":"Block height (for example 974000) or block hash (64 hex characters)"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"as_of":"2026-11-07T18:00:00Z","miner":{"pool":"Foundry USA","coinbase_tag":"Foundry USA Pool #dropgold"},"height":974000,"product":"block_stats","tx_count":3600,"total_fees_btc":0.025,"fee_rate_sat_vb":{"percentiles_10_25_50_75_90":[1,1.5,2,3,6]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8IS2O67iZi771A2CN0-Jv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches detailed statistics for a specific Bitcoin block by height or hash, including miner, transaction count, fees, and fee-rate percentiles.","exampleAgentPrompt":"Pull up the block stats for Bitcoin block 974000 — I want to know which mining pool mined it, how many transactions it had, the total fees collected, and the fee-rate percentiles.","exampleUseCases":[{"title":"Identify miner of a specific block","prompt":"Which mining pool mined Bitcoin block 840000, and what was the coinbase tag they used?"},{"title":"Analyze fee market for a past block","prompt":"What were the 10th, 25th, 50th, 75th, and 90th percentile fee rates in sat/vB for Bitcoin block 850000? I want to understand what the fee market looked like at that height."},{"title":"Audit block transaction volume and fees","prompt":"Look up Bitcoin block 974000 and tell me the total number of transactions and the total fees collected in BTC — I'm putting together an on-chain activity report."}],"resultDescription":"Returns a JSON object with the block height, UTC timestamp, miner pool name and coinbase tag, total transaction count, total fees in BTC, and an array of fee-rate percentiles (10th, 25th, 50th, 75th, 90th) in sat/vB for the specified block.","failureModes":["Invalid or non-existent block height returns an error","Malformed block hash (not 64 hex characters) returns a validation error","Block not yet mined (future height) returns not found","Rate limiting or payment failure returns 402 Payment Required","Network or node sync lag may return stale data for very recent blocks"],"whenToPreferThis":"Use this endpoint when you need granular per-block statistics — miner attribution, fee distributions, and transaction counts — for a specific Bitcoin block identified by height or hash. It is preferable to general Bitcoin network-status endpoints when the query is block-specific rather than network-wide, and preferable to mempool endpoints when the block has already been confirmed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:31:07.285Z","isFirstParty":false,"canonicalSlug":"diamond-bitcoin-block-stats-b28b35b9"}