# chainquery Bitcoin getdifficulty RPC

> chainquery Bitcoin getdifficulty RPC is a paid API for AI agents from x402.chainquery.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the current proof-of-work difficulty from Bitcoin Core via a pay-per-call x402 endpoint, no API key required.

## Facts

- Endpoint: GET https://x402.chainquery.com/v1/rpc/getdifficulty
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainquery-bitcoin-getdifficulty-rpc-6a404c0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KWxZ5UnLVdH0FmEJYwWP-

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 chainquery-bitcoin-getdifficulty-rpc-6a404c0d
```

Example prompt: What's the current Bitcoin proof-of-work mining difficulty right now, according to an independent full node?

## When to prefer this

Use this endpoint when you need the current Bitcoin network difficulty from an independent full node without setting up your own node or obtaining an API key. Ideal for agents that need trustless, third-party-verified difficulty data on a pay-per-use basis without subscription overhead.

## Known failure modes

- Payment not included or insufficient — returns HTTP 402 requiring x402 payment
- Invalid or unsupported RPC method — returns error response
- Node temporarily unavailable — returns HTTP 5xx
- Malformed params query parameter — JSON parse error returned

## How this service works

chainquery Bitcoin RPC: pay-per-call Bitcoin Core over x402, no API key. Current proof-of-work difficulty from chainquery's independent full node. Bitcoin Core getdifficulty.

## Output

A numeric floating-point value representing the current Bitcoin proof-of-work difficulty as reported by chainquery's independent Bitcoin Core full node. The result is returned in the standard Bitcoin Core RPC response envelope with a 'result' field.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "params": {
       "type": "string",
       "description": "optional: JSON-encoded array of positional RPC params"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "description": "getdifficulty result"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainquery-bitcoin-getdifficulty-rpc-6a404c0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.chainquery.com](https://www.zero.xyz/host/x402.chainquery.com/llms.txt)