{
  "x402Version": 2,
  "id": 72746,
  "slug": "saylorinnovations-api-explorer-bitcoin-difficulty-adjustment",
  "resource": "https://saylorinnovations.com/api/explorer/bitcoin/difficulty-adjustment",
  "description": "Bitcoin difficulty adjustment estimate: progress through the 2016-block period, average block time, projected change and expected retarget time.",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "chain": {
        "type": "string",
        "description": "the chain this describes"
      },
      "block_height": {
        "type": "number",
        "description": "best block height"
      },
      "current_difficulty": {
        "type": "number",
        "description": "current difficulty"
      },
      "period_start_height": {
        "type": "number",
        "description": "first block of this 2016-block period"
      },
      "blocks_into_period": {
        "type": "number",
        "description": "blocks mined in this period"
      },
      "blocks_remaining": {
        "type": "number",
        "description": "blocks until the retarget"
      },
      "progress_pct": {
        "type": "number",
        "description": "share of the period completed"
      },
      "avg_block_time_seconds_this_period": {
        "type": "number",
        "description": "average block time this period"
      },
      "projected_difficulty_change_pct": {
        "type": "number",
        "description": "projected change at the next retarget"
      },
      "projected_difficulty": {
        "type": "number",
        "description": "projected new difficulty"
      },
      "estimated_retarget_time": {
        "type": "string",
        "description": "estimated retarget time"
      },
      "estimated_hours_until_retarget": {
        "type": "number",
        "description": "hours until then"
      },
      "note": {
        "type": "string",
        "description": "plain-language reading of the result, including units"
      },
      "source": {
        "type": "string",
        "description": "where the data was read from"
      }
    },
    "required": [
      "chain",
      "block_height",
      "current_difficulty",
      "blocks_remaining",
      "projected_difficulty_change_pct",
      "estimated_retarget_time",
      "note",
      "source"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET"
        },
        "output": {
          "type": "json",
          "example": {
            "chain": "bitcoin",
            "block_height": 972405,
            "current_difficulty": 140577680051919.6,
            "period_start_height": 971712,
            "blocks_into_period": 693,
            "blocks_remaining": 1323,
            "progress_pct": 34.38,
            "avg_block_time_seconds_this_period": 569.5,
            "projected_difficulty_change_pct": 5.36,
            "projected_difficulty": 148118995934390,
            "estimated_retarget_time": "2026-10-29T19:31:05.545Z",
            "estimated_hours_until_retarget": 208.8,
            "note": "Bitcoin retargets every 2016 blocks to bring the average block time back to 10 minutes. This projects the change if the rest of the period runs at the pace seen so far (capped at 4x either way) and dates the retarget the same way. Early in a period the estimate is noisy.",
            "source": "Bitcoin Core JSON-RPC (public node)"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "description": "the chain this describes"
                  },
                  "block_height": {
                    "type": "number",
                    "description": "best block height"
                  },
                  "current_difficulty": {
                    "type": "number",
                    "description": "current difficulty"
                  },
                  "period_start_height": {
                    "type": "number",
                    "description": "first block of this 2016-block period"
                  },
                  "blocks_into_period": {
                    "type": "number",
                    "description": "blocks mined in this period"
                  },
                  "blocks_remaining": {
                    "type": "number",
                    "description": "blocks until the retarget"
                  },
                  "progress_pct": {
                    "type": "number",
                    "description": "share of the period completed"
                  },
                  "avg_block_time_seconds_this_period": {
                    "type": "number",
                    "description": "average block time this period"
                  },
                  "projected_difficulty_change_pct": {
                    "type": "number",
                    "description": "projected change at the next retarget"
                  },
                  "projected_difficulty": {
                    "type": "number",
                    "description": "projected new difficulty"
                  },
                  "estimated_retarget_time": {
                    "type": "string",
                    "description": "estimated retarget time"
                  },
                  "estimated_hours_until_retarget": {
                    "type": "number",
                    "description": "hours until then"
                  },
                  "note": {
                    "type": "string",
                    "description": "plain-language reading of the result, including units"
                  },
                  "source": {
                    "type": "string",
                    "description": "where the data was read from"
                  }
                },
                "required": [
                  "chain",
                  "block_height",
                  "current_difficulty",
                  "blocks_remaining",
                  "projected_difficulty_change_pct",
                  "estimated_retarget_time",
                  "note",
                  "source"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "bitcoin difficulty adjustment",
    "next difficulty change",
    "retarget estimate",
    "average block time",
    "mining difficulty forecast"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.989Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {},
      "required": []
    },
    "exampleResponse": {
      "chain": "bitcoin",
      "block_height": 972405,
      "current_difficulty": 140577680051919.6,
      "period_start_height": 971712,
      "blocks_into_period": 693,
      "blocks_remaining": 1323,
      "progress_pct": 34.38,
      "avg_block_time_seconds_this_period": 569.5,
      "projected_difficulty_change_pct": 5.36,
      "projected_difficulty": 148118995934390,
      "estimated_retarget_time": "2026-10-29T19:31:05.545Z",
      "estimated_hours_until_retarget": 208.8,
      "note": "Bitcoin retargets every 2016 blocks to bring the average block time back to 10 minutes. This projects the change if the rest of the period runs at the pace seen so far (capped at 4x either way) and dates the retarget the same way. Early in a period the estimate is noisy.",
      "source": "Bitcoin Core JSON-RPC (public node)"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET"
          },
          "output": {
            "type": "json",
            "example": {
              "chain": "bitcoin",
              "block_height": 972405,
              "current_difficulty": 140577680051919.6,
              "period_start_height": 971712,
              "blocks_into_period": 693,
              "blocks_remaining": 1323,
              "progress_pct": 34.38,
              "avg_block_time_seconds_this_period": 569.5,
              "projected_difficulty_change_pct": 5.36,
              "projected_difficulty": 148118995934390,
              "estimated_retarget_time": "2026-10-29T19:31:05.545Z",
              "estimated_hours_until_retarget": 208.8,
              "note": "Bitcoin retargets every 2016 blocks to bring the average block time back to 10 minutes. This projects the change if the rest of the period runs at the pace seen so far (capped at 4x either way) and dates the retarget the same way. Early in a period the estimate is noisy.",
              "source": "Bitcoin Core JSON-RPC (public node)"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "the chain this describes"
                    },
                    "block_height": {
                      "type": "number",
                      "description": "best block height"
                    },
                    "current_difficulty": {
                      "type": "number",
                      "description": "current difficulty"
                    },
                    "period_start_height": {
                      "type": "number",
                      "description": "first block of this 2016-block period"
                    },
                    "blocks_into_period": {
                      "type": "number",
                      "description": "blocks mined in this period"
                    },
                    "blocks_remaining": {
                      "type": "number",
                      "description": "blocks until the retarget"
                    },
                    "progress_pct": {
                      "type": "number",
                      "description": "share of the period completed"
                    },
                    "avg_block_time_seconds_this_period": {
                      "type": "number",
                      "description": "average block time this period"
                    },
                    "projected_difficulty_change_pct": {
                      "type": "number",
                      "description": "projected change at the next retarget"
                    },
                    "projected_difficulty": {
                      "type": "number",
                      "description": "projected new difficulty"
                    },
                    "estimated_retarget_time": {
                      "type": "string",
                      "description": "estimated retarget time"
                    },
                    "estimated_hours_until_retarget": {
                      "type": "number",
                      "description": "hours until then"
                    },
                    "note": {
                      "type": "string",
                      "description": "plain-language reading of the result, including units"
                    },
                    "source": {
                      "type": "string",
                      "description": "where the data was read from"
                    }
                  },
                  "required": [
                    "chain",
                    "block_height",
                    "current_difficulty",
                    "blocks_remaining",
                    "projected_difficulty_change_pct",
                    "estimated_retarget_time",
                    "note",
                    "source"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/explorer/bitcoin/difficulty-adjustment",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "chain": "string",
    "block_height": 0,
    "current_difficulty": 0,
    "period_start_height": 0,
    "blocks_into_period": 0,
    "blocks_remaining": 0,
    "progress_pct": 0,
    "avg_block_time_seconds_this_period": 0,
    "projected_difficulty_change_pct": 0,
    "projected_difficulty": 0,
    "estimated_retarget_time": "string",
    "estimated_hours_until_retarget": 0,
    "note": "string",
    "source": "string"
  }
}