{"uid":"cap_LCA6euPCim59V-j0QN_Y-","slug":"api-web3identity-com-cf342e29","name":"Bitcoin Mining Difficulty & Adjustment History","description":"Bitcoin mining difficulty with adjustment history","url":"https://api.web3identity.com/api/bitcoin/difficulty","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"change":{"type":"number"},"current":{"type":"number"},"history":{"type":"array"},"nextAdjustment":{"type":"object"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"source":"blockchain.info","timestamp":"2026-06-16T01:14:59.515Z","difficulty":124932866006548}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.010000/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_1oPRBasK4wD7yEbnmc_EI","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 the current Bitcoin mining difficulty, recent change percentage, and historical adjustment records along with the next scheduled adjustment details.","exampleAgentPrompt":"What's the current Bitcoin mining difficulty, how much did it change in the last adjustment, and when is the next adjustment scheduled?","exampleUseCases":[{"title":"Monitor Bitcoin network difficulty trend","prompt":"Can you pull the recent Bitcoin mining difficulty history and tell me if it's been trending up or down over the last several adjustments?"},{"title":"Forecast next difficulty adjustment timing","prompt":"When is the next Bitcoin difficulty adjustment expected to happen, and based on recent changes, do we have any sense of which direction it might go?"},{"title":"Assess mining profitability conditions","prompt":"How hard is it to mine Bitcoin right now compared to a few adjustments ago? I'm trying to figure out if current difficulty levels are favorable for our mining operation."}],"resultDescription":"Returns a JSON object with: current difficulty (numeric), recent percentage change, an array of historical adjustment records, and a nextAdjustment object containing details about the upcoming scheduled difficulty change.","failureModes":["Upstream Bitcoin node data unavailable — service may return 503","Rate limiting or payment failure — returns 402 if x402 payment not processed","Malformed response if blockchain data is temporarily inconsistent","Network timeout if Bitcoin RPC layer is slow"],"whenToPreferThis":"Use this endpoint when you need real-time Bitcoin mining difficulty data combined with historical adjustment context and next-adjustment forecasting in a single call. Prefer this over raw blockchain explorers when you need structured, aggregated difficulty history without parsing raw block data yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:49:26.543Z","isFirstParty":false}