{"uid":"cap_CTYX1bthqojRBqgMv9ryv","slug":"bitcoin-cpfp-fee-bump-plan-a66b0df3","name":"Bitcoin CPFP Fee Bump Plan","description":"CPFP budget scenarios for a mempool transaction and its ancestors. package=txid:target_sat_vb:child_vbytes[,child_vbytes...]. Up to 25 unique sizes; actual ancestor base fees, ceiling arithmetic and observed relay/mempool floors. Not transaction construction, package-policy validation, broadcast or ","url":"https://diamond.btc-intel.workers.dev/api/x402/cpfp?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":["package"],"properties":{"package":{"type":"string","maxLength":255,"description":"txid:target_sat_vb:child_vbytes[,child_vbytes...]. Target 0.001..10000 sat/vB (up to 3 decimals), one to 25 unique child sizes of 60..100000 vbytes."}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"as_of":"<UTC timestamp>","plans":[],"terms":"A fee arithmetic estimate, not a transaction, broadcast, relay-policy validation or confirmation guarantee. Assumes one child spending an available output of the selected transaction and no additional unconfirmed inputs. Child size is buyer-supplied. Uses actual base fees of the observed transaction and its ancestors, excluding local fee deltas. Other miners and nodes can have different views and policies. Check output ownership, available value, descendants and package policy. Paid replay preserves the original snapshot; recheck current conditions before acting.","product":"cpfp_budget_batch"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y_Umg6RvugYzXzWhr51h2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates CPFP (Child-Pays-For-Parent) fee budget scenarios for a stuck mempool transaction, showing how much a child transaction must pay to accelerate confirmation at a target fee rate.","exampleAgentPrompt":"My Bitcoin transaction abc123...txid is stuck in the mempool — figure out how much a child transaction would need to pay to bump the whole package to 20 sat/vB, assuming child sizes of 150, 250, and 400 vbytes.","exampleUseCases":[{"title":"Rescue a stuck low-fee transaction","prompt":"Transaction b3d7f1...2a9c is stuck in the mempool with a very low fee rate. Can you calculate how much a CPFP child transaction of 200 vbytes would need to pay to bring the whole package up to 15 sat/vB?"},{"title":"Comparison shop child sizes for fee bump","prompt":"I need to bump my stuck transaction 4f8e2b...7c1d to 25 sat/vB. Can you run CPFP fee estimates for child transaction sizes of 150, 250, 350, and 500 vbytes so I can pick the cheapest option?"},{"title":"Wallet app CPFP cost preview","prompt":"Before I build a CPFP transaction, show me what the fee budget would look like for transaction 9a1c3e...5f2b targeting 10 sat/vB with a 180-vbyte child — I want to see the actual ancestor fees factored in."}],"resultDescription":"Returns a JSON object with a timestamp, an array of fee plans (one per child size) showing how many satoshis the child must pay given the ancestor's observed base fees and the target fee rate, plus a terms disclaimer clarifying this is arithmetic estimation only — not transaction construction, broadcast, or confirmation guarantee.","failureModes":["Invalid or unrecognized txid returns an error or empty plans array","Target fee rate outside 0.001–10000 sat/vB range is rejected","Child vbyte sizes outside 60–100000 range are rejected","More than 25 unique child sizes returns a validation error","Transaction not found in mempool (confirmed or unknown) may return empty or error response","Stale snapshot if transaction conditions change between payment and result delivery"],"whenToPreferThis":"Use this endpoint when you need fee arithmetic for CPFP fee-bumping of a specific stuck mempool transaction, especially when you want to compare multiple child transaction sizes at once. It is preferred over generic fee estimators because it incorporates the actual observed ancestor base fees for the specific transaction, not just current mempool conditions. It does not construct or broadcast transactions, so it is safe to call speculatively for planning purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:36:00.783Z","isFirstParty":false,"canonicalSlug":"bitcoin-cpfp-fee-bump-plan-a66b0df3"}