# Bitcoin Difficulty Adjustment Progress and Estimate

> Bitcoin Difficulty Adjustment Progress and Estimate is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-01).

Returns the current Bitcoin difficulty adjustment progress and estimated next difficulty change, including how far into the current epoch we are and the projected adjustment percentage.

## Facts

- Endpoint: POST https://twin.unykorn.org/btc-difficulty?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-difficulty-adjustment-progress-and-estimate-24fe4bb0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZsbBuv2za2agyExWp0r5Z

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-difficulty-adjustment-progress-and-estimate-24fe4bb0 -d '<json body>'
```

Example prompt: What's the current Bitcoin difficulty adjustment progress — how far into the epoch are we and what's the estimated percentage change for the next retarget?

## When to prefer this

Choose this endpoint when you need a quick, single-call lookup of Bitcoin difficulty adjustment state including epoch progress and projected change percentage, especially in agentic or automated workflows that bill per-call via x402 micropayments. Prefer it over running your own Bitcoin node queries when you want a lightweight, pay-per-use REST interface without infrastructure overhead.

## Known failure modes

- Network or upstream Bitcoin node unavailability causing failed data retrieval
- Payment processing failure resulting in no response
- Malformed response if upstream data source is temporarily inconsistent
- Rate limiting or quota exceeded on the operator network

## How this service works

Bitcoin difficulty adjustment progress and estimate — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with ok status, a type of 'btc-difficulty', a generated_at ISO8601 timestamp, and a payment receipt including transaction hash, USD amount, and receipt ID. The core payload contains the current difficulty adjustment progress within the epoch and the estimated percentage change for the upcoming retarget.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {}
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "btc-difficulty",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.003,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-difficulty-adjustment-progress-and-estimate-24fe4bb0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)