{"uid":"cap_8wsiOtUDpeHuax7v5CUvK","slug":"fastpath-api-bitcoin-fee-ladder-155726b4","name":"FastPath API - Bitcoin Fee Ladder","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/fee-ladder","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"targetBlocks":{"type":"number","minimum":1,"description":"Desired confirmation target in blocks."}}},"responseSchema":{"type":"json","example":{"ladder":{"cheap":{"satVb":1,"targetBlocks":144},"normal":{"satVb":1,"targetBlocks":6},"urgent":{"satVb":2,"targetBlocks":1}},"source":"core_v31_optimizer_cache","success":true}},"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_vP1Cb0TwuRU2QfEF5H12g","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 a tiered fee ladder (cheap/normal/urgent) with sat/vbyte estimates and block targets from Core v31 optimizer cache","exampleAgentPrompt":"What are the current Bitcoin fee tiers — cheap, normal, and urgent — in sat/vbyte from the Core v31 optimizer cache, targeting 6 blocks for normal confirmation?","exampleUseCases":null,"resultDescription":"A JSON object containing a fee ladder with three tiers: cheap (sat/vbyte and block target), normal (sat/vbyte and block target), and urgent (sat/vbyte and block target), along with the data source label and a success flag.","failureModes":["Invalid targetBlocks value (below minimum of 1) returns validation error","Core v31 optimizer cache unavailable returns error or stale data","Payment failure via x402 returns 402 Payment Required","Network timeout returns 5xx server error"],"whenToPreferThis":"Use this endpoint when you need a structured multi-tier Bitcoin fee recommendation (cheap/normal/urgent) derived from Bitcoin Core v31's optimizer cache, especially when building wallets, transaction fee selectors, or dashboards that need tiered fee guidance rather than a single point estimate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:24.754Z","isFirstParty":false}