{"uid":"cap_CXQRQK5kWNonlC4wRjnfj","slug":"bitcoin-batch-fee-planner-cca720dd","name":"Bitcoin Batch Fee Planner","description":"Batch fee-budget analysis for one to 25 transaction sizes. plan=budget_sats:vbytes[,vbytes...]. The budget is a per-transaction cap in sats. Returns rounded-up fee estimates and the fastest observed estimate fitting each cap. Uses fresh independent-node observations; no confirmation guarantee.","url":"https://diamond.btc-intel.workers.dev/api/x402/feeplan?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":["plan"],"properties":{"plan":{"type":"string","maxLength":185,"description":"Per-transaction fee cap in sats, colon, and one to 25 comma-separated transaction sizes in vbytes. Example 1000:140,220,350. Fee cap 1..100000000; each size 60..100000."}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"as_of":"<UTC timestamp>","plans":[{"vbytes":140,"options":[],"fee_cap_sats":1000,"fastest_estimate_within_budget":"<estimate label or null>"}],"terms":"Independent-node estimates, not guaranteed confirmation times. The budget is a per-transaction fee cap in sats, and each vsize entry is evaluated against that cap. Transaction sizes are supplied by the buyer. Node relay policies and network conditions can change. No transaction is signed or sent.","product":"fee_plan_batch","plan_count":3,"observing_node":"Diamond"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_tHR88YWd0q1PyiuNtLSQ7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns fee estimates for 1–25 Bitcoin transaction sizes against a single per-transaction sats budget, flagging the fastest confirmable option within that cap.","exampleAgentPrompt":"Can you check if a 1000 sat fee budget is enough for Bitcoin transactions of 140, 220, and 350 vbytes, and tell me which size gets the fastest confirmation within that budget?","exampleUseCases":[{"title":"Pre-send fee check for wallet app","prompt":"Before I broadcast this Bitcoin transaction, check if my 2000 sat fee cap works for a 250 vbyte transaction and show me the fastest estimate that fits."},{"title":"Batch payment fee planning","prompt":"I'm about to send a batch of Bitcoin payments — the transactions are 140, 300, 480, and 680 vbytes. Can you tell me which ones fit under a 1500 sat per-transaction fee budget and which is the fastest confirmable?"},{"title":"Fee sensitivity analysis across sizes","prompt":"Run a fee plan for transaction sizes of 60, 120, 200, and 400 vbytes with a 5000 sat budget so I can see my options before choosing an output size."}],"resultDescription":"A JSON object containing a UTC timestamp, the observing node name, one plan entry per submitted vbyte size (each showing the fee cap, available options, and the label of the fastest estimate fitting within budget or null if none fit), plus a disclaimer about network conditions and confirmation times.","failureModes":["plan parameter missing or malformed — returns error if format deviates from budget_sats:vbytes","fee cap out of range (must be 1–100,000,000 sats) — validation error","vbyte value out of range (must be 60–100,000 per size) — validation error","more than 25 transaction sizes submitted — rejected","network or node connectivity issues may return stale or unavailable data","fastest_estimate_within_budget returns null when no estimate fits within the cap"],"whenToPreferThis":"Use this endpoint when you need to evaluate Bitcoin transaction fee feasibility across multiple transaction sizes in a single call, particularly when working with a fixed sat budget and wanting to know the fastest confirmable option within that constraint. Prefer it over single-transaction fee estimators when batching payment planning or comparing output sizes. It is not a broadcast or signing service — purely advisory.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:36:47.459Z","isFirstParty":false,"canonicalSlug":"bitcoin-batch-fee-planner-cca720dd"}