{"uid":"cap_hpYplAPnryAwNET4Lwe1S","slug":"fastpath-api-bitcoin-template-batch-check-0f23da4d","name":"FastPath API – Bitcoin Template Batch Check","description":"FastPath translates Ethereum-style JSON-RPC requests into Bitcoin data, fee intelligence, mempool insight, and Core v31 package signals. Paid by x402.","url":"https://api.nativebtc.org/v1/template/batch-check","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"txids":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{64}$","description":"Bitcoin transaction ID as 64 lowercase or uppercase hex characters."},"maxItems":10,"minItems":1},"targetBlocks":{"type":"number","minimum":1,"description":"Desired confirmation target in blocks."}}},"responseSchema":{"type":"json","example":{"mode":"live_cached","source":"core_v31_optimizer_cache","results":[{"txid":"81c97a6c5b98a1019095de132727cda868694fb5d92534ebb07e475619e38325","inOptimizedTemplate":true}],"success":true,"included":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vqvkhzgYZEPAuwxno49ZW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a batch of Bitcoin transaction IDs are included in the Core v31 optimized mempool template, given a target block confirmation window.","exampleAgentPrompt":"Can you batch-check whether these 3 Bitcoin txids — 81c97a6c5b98a1019095de132727cda868694fb5d92534ebb07e475619e38325, abc123...def456, and 999aaa...bbb000 — are currently included in the Core v31 optimized block template, targeting confirmation within 3 blocks?","exampleUseCases":[{"title":"Pre-confirmation transaction monitoring","prompt":"I just broadcast these 5 Bitcoin transactions — can you check if any of them have made it into the Core v31 optimized block template yet? I'm targeting confirmation within the next 2 blocks. Here are the txids: [txid1, txid2, txid3, txid4, txid5]."},{"title":"Fee bumping decision support","prompt":"Before I decide whether to RBF-bump these transactions, can you check if they're already in the miner's optimized template for the next 6 blocks? Txids are: 81c97a6c5b98a1019095de132727cda868694fb5d92534ebb07e475619e38325 and aabbcc...112233."},{"title":"Batch settlement verification for exchange","prompt":"We just processed a batch of 10 Bitcoin withdrawals and need to know which ones are included in the Core v31 block template for the next block — can you run a batch check on these txids and tell me how many made it in?"}],"resultDescription":"Returns a JSON object with a mode field (e.g. 'live_cached'), source identifier (e.g. 'core_v31_optimizer_cache'), a results array where each entry contains the txid and a boolean 'inOptimizedTemplate' flag, an 'included' count, and a 'success' boolean.","failureModes":["Invalid txid format (not 64 hex characters) returns a validation error","Exceeding 10 txids in a single batch returns a schema violation error","targetBlocks below 1 rejected as invalid","Payment failure via x402 protocol returns 402 Payment Required","txid not found in mempool may return inOptimizedTemplate: false without explicit error","Temporary Core node unavailability may return a non-success response"],"whenToPreferThis":"Use this endpoint when you need to batch-verify whether specific Bitcoin transactions are included in Bitcoin Core v31's optimized block template, particularly when making RBF-bump or fee decisions, verifying settlement batches, or monitoring near-term confirmation likelihood. Prefer this over single-transaction mempool lookups when you have up to 10 txids to check simultaneously. It is distinct from general mempool fee estimation — this specifically checks template inclusion status via the Core v31 optimizer cache.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:39.034Z","isFirstParty":false}