# Bitcoin Mining Difficulty Lookup

> Bitcoin Mining Difficulty Lookup is a paid API for AI agents from finance-api.kdlcfa.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the current Bitcoin mining difficulty value via the Blockchain.info stats API

## Facts

- Endpoint: GET https://finance-api.kdlcfa.workers.dev/btc-difficulty
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-mining-difficulty-lookup-0856c7f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k1fz1a8Ux-qxk1sungscp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bitcoin-mining-difficulty-lookup-0856c7f3
```

Example prompt: What's the current Bitcoin mining difficulty? I want to know how hard it is to mine BTC on the network right now.

## When to prefer this

Choose this endpoint when you need the current Bitcoin mining difficulty as a raw numeric value, especially in automated pipelines or agents that require live blockchain stats without building direct Blockchain.info integration. Ideal for crypto dashboards, miner profitability calculators, or monitoring workflows that need a simple, pay-per-call approach via x402.

## Known failure modes

- Upstream Blockchain.info API unavailability may return a 502 or 503 error
- Stale or cached data if Blockchain.info stats endpoint is lagging
- Network timeout if the Cloudflare Worker cannot reach the upstream provider
- Payment not received or invalid x402 payment resulting in 402 error

## How this service works

Bitcoin mining difficulty, via Blockchain.info stats API

## Output

Returns a numeric value representing the current Bitcoin mining difficulty, sourced from the Blockchain.info stats API. The difficulty value indicates how hard it is to find a valid block hash on the Bitcoin network, reflecting the network's computational challenge level at the time of the request.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-mining-difficulty-lookup-0856c7f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finance-api.kdlcfa.workers.dev](https://www.zero.xyz/host/finance-api.kdlcfa.workers.dev/llms.txt)