--- name: cdp.bitcoinsapi.com description: cdp.bitcoinsapi.com provides Bitcoin mempool intelligence and transaction analysis through four single-shot API skills. It covers fee estimation, next-block mining snapshots, fee landscape summaries, and AI-generated explanations of individual transactions by txid. host: cdp.bitcoinsapi.com --- # cdp.bitcoinsapi.com This host serves agents that need to make or explain Bitcoin transaction fee decisions. It combines raw mempool data (next-block snapshot, fee landscape) with AI-interpreted advisory outputs (fee advice, transaction explanation). All skills are Bitcoin mainnet only and operate as single-shot calls rather than streaming feeds. It is suited for wallet tooling, transaction construction pipelines, and user-facing fee guidance interfaces. ## When to use this host Use this host when an agent needs Bitcoin-specific fee intelligence: setting a fee before broadcasting, advising a user on whether to send now or wait, or explaining a specific transaction's fee characteristics. Do not use it for Ethereum or other chain gas estimation — use a chain-specific gas API instead. Do not use it for historical fee data or confirmed block statistics — use a Bitcoin block explorer API (e.g., Mempool.space or Blockstream) instead. Do not use it for continuous or streaming fee monitoring — all skills are single-shot and must be polled manually. It is not suitable for bulk transaction analysis; fetch-bitcoin-transaction-explanation processes one txid per call. ## Capabilities ### Mempool Snapshot Data Provides raw, real-time snapshots of current Bitcoin mempool conditions, including next-block projections and fee estimates across confirmation targets. - **`fetch-bitcoin-next-block-mining-data`** — Returns a real-time snapshot of the Bitcoin mainnet next block, including block height, transaction count, weight, and the top 5 fee-paying transactions with fee rates and fee amounts in satoshis. - **`fetch-bitcoin-fee-landscape`** — Returns current Bitcoin mempool fee conditions including send/wait recommendation, fee estimates for next block, 6 blocks, and 1 day, trend direction, and scenario cost breakdowns. ### AI Fee Advisory Delivers AI-interpreted fee recommendations and urgency guidance, translating raw mempool conditions into actionable send/wait decisions with confidence levels. - **`fetch-bitcoin-fee-advice`** — Returns an AI-generated Bitcoin transaction fee recommendation with suggested sat/vByte rate, action guidance, confidence level, and current mempool fee environment data. - **`fetch-bitcoin-fee-landscape`** — Returns current Bitcoin mempool fee conditions including send/wait recommendation, fee estimates for next block, 6 blocks, and 1 day, trend direction, and scenario cost breakdowns. ### Transaction Explanation Accepts a txid and returns a human-readable AI-generated interpretation of that transaction's fee rate, size, and urgency relative to current network conditions. - **`fetch-bitcoin-transaction-explanation`** — Returns an AI-generated explanation of a Bitcoin transaction by txid, including virtual size, fee rate, and an interpretation of payment urgency relative to current network conditions. ## Workflows ### Fee-Optimized Transaction Preparation *Use when an agent needs to construct a Bitcoin transaction and wants both a raw mempool context and an AI-recommended fee rate before setting the fee.* 1. **`fetch-bitcoin-next-block-mining-data`** — Retrieve the current next-block snapshot to understand projected block height, weight, and top fee-rate transactions. 2. **`fetch-bitcoin-fee-landscape`** — Retrieve the current fee landscape to get send/wait recommendation and sat/vB estimates for next-block, 6-block, and 1-day confirmation targets. 3. **`fetch-bitcoin-fee-advice`** — Pass the agent's urgency level to receive an AI-recommended sat/vByte rate and action guidance informed by the mempool context already retrieved. ### Transaction Post-Broadcast Audit *Use when an agent needs to explain a recently broadcast or pending Bitcoin transaction's fee rate and urgency to a user or downstream system.* 1. **`fetch-bitcoin-fee-landscape`** — Retrieve current mempool fee conditions to establish the baseline fee environment at the time of audit. 2. **`fetch-bitcoin-transaction-explanation`** — Pass the txid to receive an AI-generated explanation of the transaction's fee rate and urgency relative to the current network conditions. ## Skill reference ### `fetch-bitcoin-fee-advice` **Bitcoin Fee Advice** — Returns an AI-generated Bitcoin transaction fee recommendation with suggested sat/vByte rate, action guidance, confidence level, and current mempool fee environment data. *Use when:* Use when an agent needs to determine an appropriate Bitcoin transaction fee rate before constructing or broadcasting a transaction, especially when optimizing for cost vs. confirmation speed under current mempool conditions. *Not for:* Do not use for Ethereum or other non-Bitcoin fee estimation; use a chain-specific gas estimation API instead. Not suitable for real-time streaming fee monitoring — this is a single-shot advisory call. **Inputs:** - `urgency` (string) — Desired confirmation urgency level influencing the fee recommendation. Inferred from context if not provided. **Returns:** Returns a structured AI fee recommendation with recommended sat/vByte rate, action ('send' or 'wait'), confidence, fee environment label, estimated savings, raw mempool fee tiers, and node metadata. **Example:** `GET https://cdp.bitcoinsapi.com/api/v1/ai/fees/advice` --- ### `fetch-bitcoin-next-block-mining-data` **Bitcoin Next Block Mining Data** — Returns a real-time snapshot of the Bitcoin mainnet next block, including block height, transaction count, weight, and the top 5 fee-paying transactions with fee rates and fee amounts in satoshis. *Use when:* Use when an agent needs current Bitcoin mempool next-block data such as the projected block height, transaction count, block weight, or the highest fee-rate transactions likely to be included in the next block. *Not for:* Do not use for historical block data or confirmed block statistics; use a Bitcoin block explorer API instead. Not suitable for real-time streaming fee rate feeds — this is a single-shot snapshot. **Returns:** Returns a JSON object with next-block height, transaction count, total weight, nullable fee summary fields, and an array of the top 5 fee-paying transactions with txid, fee_rate, and fee_sats, plus metadata including timestamp, node height, and cache status. **Example:** `GET https://cdp.bitcoinsapi.com/api/v1/mining/nextblock` --- ### `fetch-bitcoin-transaction-explanation` **Bitcoin Transaction Explain API** — Returns an AI-generated explanation of a Bitcoin transaction by txid, including virtual size, fee rate, and an interpretation of payment urgency relative to current network conditions. *Use when:* Use when an agent needs a human-readable interpretation of a specific Bitcoin transaction's fee rate, size, and urgency, given a known txid. *Not for:* Do not use for real-time mempool monitoring or bulk transaction analysis; this is a single-shot explanation for one txid at a time. **Inputs:** - `txid` (string, required) — The Bitcoin transaction ID (txid) to explain, provided as the last path segment of the URL. **Returns:** Returns a data object with the txid, an AI-generated explanation of virtual size, fee rate, and urgency, plus meta fields including block height, chain, and cache status. **Example:** `GET https://cdp.bitcoinsapi.com/api/v1/ai/explain/transaction/66b3e61d2c9a5e3fb79d3a0dd291efc1864cb7cc4b09c951f6b3d8927c734b59` --- ### `fetch-bitcoin-fee-landscape` **Bitcoin Fee Landscape API** — Returns current Bitcoin mempool fee conditions including send/wait recommendation, fee estimates for next block, 6 blocks, and 1 day, trend direction, and scenario cost breakdowns. *Use when:* Use when an agent needs to advise a user on whether to send a Bitcoin transaction now or wait, or needs current sat/vB fee estimates for different confirmation targets. *Not for:* Do not use for real-time streaming fee updates or historical fee data; this is a single-shot snapshot of current mempool conditions. **Returns:** Returns a data object with send/wait recommendation, confidence, fee environment level, trend direction and mempool change percent, current fee rates for next block/6 blocks/1 day, three cost scenarios, and metadata including node height and cache status. **Example:** `GET https://cdp.bitcoinsapi.com/api/v1/fees/landscape` ---