{"uid":"cap_HUAyp4aRgwWcs6S3C1Gl9","slug":"satoshi-api-ai-explained-bitcoin-block-lookup-17a99b2d","name":"Satoshi API – AI-Explained Bitcoin Block Lookup","description":"Know when to send Bitcoin and when to wait. Satoshi API gives apps and AI agents live fee recommendations, mempool context, and cost estimates. Free, open source.","url":"https://bitcoinsapi.com/api/v1/ai/explain/block/%7Bhash_or_height%7D","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"source":{"type":"string"}}},"example":{"ok":true,"source":"satoshi-api"},"mimeType":"application/json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_g13aCUaanCs8xz5nQP9-f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an AI-generated natural-language explanation of a specific Bitcoin block identified by its hash or height, including fee and mempool context.","exampleAgentPrompt":"Can you give me an AI-generated plain-English explanation of Bitcoin block 840000 — what happened in it, what fees were like, and any notable mempool context?","exampleUseCases":[{"title":"Blockchain explorer narrative generation","prompt":"I'm building a Bitcoin block explorer and need a human-readable AI explanation of block 840000 — can you summarize what happened in that block, including fees and any mempool highlights?"},{"title":"Historical fee research for a specific block","prompt":"What were the fee conditions like during Bitcoin block 750000? Give me an AI-explained breakdown so I can understand the mempool environment at that time."},{"title":"AI agent Bitcoin block digest","prompt":"My agent needs to understand what occurred in the Bitcoin block with hash 000000000000000000024bead8df69990852c202c0a040e783bb07c823c1b9cc — can you generate a clear explanation of that block's contents and fee context?"}],"resultDescription":"A JSON response containing an 'ok' boolean status and a 'source' field ('satoshi-api'), along with an AI-generated natural-language explanation of the requested Bitcoin block — covering block contents, transaction fee levels, mempool conditions, and notable context at the time the block was mined.","failureModes":["Invalid or non-existent block hash returns an error or empty explanation","Block height out of range (e.g. future blocks) returns a not-found error","Malformed input schema causes a 400 bad request","Payment not provided or insufficient USDC results in a 402 payment required error","Network timeout if mempool data source is temporarily unavailable"],"whenToPreferThis":"Choose this endpoint when you need a human-readable, AI-generated narrative explanation of a specific Bitcoin block — ideal for block explorer UIs, educational tools, AI agents that need to reason about historical Bitcoin fee environments, or any app where raw block data needs to be translated into plain English. Prefer this over raw block data APIs when the consumer is a human or an LLM that benefits from contextual prose rather than structured numbers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:02.716Z","isFirstParty":false}