{
  "x402Version": 2,
  "id": 72557,
  "slug": "saylorinnovations-api-btc-halving",
  "resource": "https://saylorinnovations.com/api/btc/halving",
  "description": "Bitcoin halving countdown from a block height: next halving height, blocks and days remaining, estimated date, current subsidy and coins mined so far.",
  "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": {
      "current_height": {
        "type": "number",
        "description": "Block height supplied"
      },
      "current_era": {
        "type": "number",
        "description": "Which halving era the height is in (1 is the original 50 BTC era)"
      },
      "current_subsidy_btc": {
        "type": "number",
        "description": "Block subsidy in the current era"
      },
      "next_halving_height": {
        "type": "number",
        "description": "Block height of the next halving"
      },
      "next_subsidy_btc": {
        "type": "number",
        "description": "Block subsidy after the next halving"
      },
      "blocks_remaining": {
        "type": "number",
        "description": "Blocks until the next halving"
      },
      "estimated_days_remaining": {
        "type": "number",
        "description": "Days until the next halving at the assumed block time"
      },
      "estimated_halving_date": {
        "type": "string",
        "description": "Estimated UTC time of the next halving"
      },
      "progress_through_era_percent": {
        "type": "number",
        "description": "How far through the current era the height is"
      },
      "supply_mined_btc": {
        "type": "number",
        "description": "Cumulative subsidy issued by this height"
      },
      "max_supply_btc": {
        "type": "number",
        "description": "Maximum bitcoin supply"
      },
      "subsidy_issued_per_day_btc": {
        "type": "number",
        "description": "New bitcoin issued per day at 144 blocks"
      },
      "note": {
        "type": "string",
        "description": "Plain-language caveat about how to read and use the result"
      },
      "source": {
        "type": "string",
        "description": "Where the data or formula comes from"
      },
      "avg_block_minutes_assumed": {
        "description": "Average block time assumed",
        "type": [
          "number",
          "null"
        ]
      }
    },
    "required": [
      "next_halving_height",
      "estimated_halving_date"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "as_of": "2026-10-17",
            "current_height": "971900"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "current_height": 971900,
            "current_era": 5,
            "current_subsidy_btc": 3.125,
            "next_halving_height": 1050000,
            "next_subsidy_btc": 1.5625,
            "blocks_remaining": 78100,
            "estimated_days_remaining": 542.36,
            "estimated_halving_date": "2028-04-11T08:40:00.000Z",
            "avg_block_minutes_assumed": 10,
            "progress_through_era_percent": 62.81,
            "supply_mined_btc": 20099687.5,
            "max_supply_btc": 21000000,
            "subsidy_issued_per_day_btc": 450,
            "note": "The date assumes blocks keep arriving at the stated average. Real timing drifts with hashrate and difficulty. Supply is the cumulative subsidy by height and ignores unspendable coins.",
            "source": "Bitcoin consensus issuance schedule (210,000 block halving interval)"
          }
        }
      },
      "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"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "as_of": {
                    "type": "string",
                    "description": "optional date the height was observed, default now"
                  },
                  "current_height": {
                    "type": "string",
                    "description": "current block height (see /api/btc/network)"
                  }
                },
                "required": [
                  "current_height"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "current_height": {
                    "type": "number",
                    "description": "Block height supplied"
                  },
                  "current_era": {
                    "type": "number",
                    "description": "Which halving era the height is in (1 is the original 50 BTC era)"
                  },
                  "current_subsidy_btc": {
                    "type": "number",
                    "description": "Block subsidy in the current era"
                  },
                  "next_halving_height": {
                    "type": "number",
                    "description": "Block height of the next halving"
                  },
                  "next_subsidy_btc": {
                    "type": "number",
                    "description": "Block subsidy after the next halving"
                  },
                  "blocks_remaining": {
                    "type": "number",
                    "description": "Blocks until the next halving"
                  },
                  "estimated_days_remaining": {
                    "type": "number",
                    "description": "Days until the next halving at the assumed block time"
                  },
                  "estimated_halving_date": {
                    "type": "string",
                    "description": "Estimated UTC time of the next halving"
                  },
                  "progress_through_era_percent": {
                    "type": "number",
                    "description": "How far through the current era the height is"
                  },
                  "supply_mined_btc": {
                    "type": "number",
                    "description": "Cumulative subsidy issued by this height"
                  },
                  "max_supply_btc": {
                    "type": "number",
                    "description": "Maximum bitcoin supply"
                  },
                  "subsidy_issued_per_day_btc": {
                    "type": "number",
                    "description": "New bitcoin issued per day at 144 blocks"
                  },
                  "note": {
                    "type": "string",
                    "description": "Plain-language caveat about how to read and use the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "Where the data or formula comes from"
                  },
                  "avg_block_minutes_assumed": {
                    "description": "Average block time assumed",
                    "type": [
                      "number",
                      "null"
                    ]
                  }
                },
                "required": [
                  "next_halving_height",
                  "estimated_halving_date"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "bitcoin halving countdown",
    "when is the next btc halving",
    "blocks until halving",
    "current block subsidy",
    "how many bitcoin have been mined"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.960Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "as_of": {
          "type": "string",
          "description": "optional date the height was observed, default now"
        },
        "current_height": {
          "type": "string",
          "description": "current block height (see /api/btc/network)"
        }
      },
      "required": [
        "current_height"
      ]
    },
    "exampleResponse": {
      "current_height": 971900,
      "current_era": 5,
      "current_subsidy_btc": 3.125,
      "next_halving_height": 1050000,
      "next_subsidy_btc": 1.5625,
      "blocks_remaining": 78100,
      "estimated_days_remaining": 542.36,
      "estimated_halving_date": "2028-04-11T08:40:00.000Z",
      "avg_block_minutes_assumed": 10,
      "progress_through_era_percent": 62.81,
      "supply_mined_btc": 20099687.5,
      "max_supply_btc": 21000000,
      "subsidy_issued_per_day_btc": 450,
      "note": "The date assumes blocks keep arriving at the stated average. Real timing drifts with hashrate and difficulty. Supply is the cumulative subsidy by height and ignores unspendable coins.",
      "source": "Bitcoin consensus issuance schedule (210,000 block halving interval)"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "as_of": "2026-10-17",
              "current_height": "971900"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "current_height": 971900,
              "current_era": 5,
              "current_subsidy_btc": 3.125,
              "next_halving_height": 1050000,
              "next_subsidy_btc": 1.5625,
              "blocks_remaining": 78100,
              "estimated_days_remaining": 542.36,
              "estimated_halving_date": "2028-04-11T08:40:00.000Z",
              "avg_block_minutes_assumed": 10,
              "progress_through_era_percent": 62.81,
              "supply_mined_btc": 20099687.5,
              "max_supply_btc": 21000000,
              "subsidy_issued_per_day_btc": 450,
              "note": "The date assumes blocks keep arriving at the stated average. Real timing drifts with hashrate and difficulty. Supply is the cumulative subsidy by height and ignores unspendable coins.",
              "source": "Bitcoin consensus issuance schedule (210,000 block halving interval)"
            }
          }
        },
        "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"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "as_of": {
                      "type": "string",
                      "description": "optional date the height was observed, default now"
                    },
                    "current_height": {
                      "type": "string",
                      "description": "current block height (see /api/btc/network)"
                    }
                  },
                  "required": [
                    "current_height"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "current_height": {
                      "type": "number",
                      "description": "Block height supplied"
                    },
                    "current_era": {
                      "type": "number",
                      "description": "Which halving era the height is in (1 is the original 50 BTC era)"
                    },
                    "current_subsidy_btc": {
                      "type": "number",
                      "description": "Block subsidy in the current era"
                    },
                    "next_halving_height": {
                      "type": "number",
                      "description": "Block height of the next halving"
                    },
                    "next_subsidy_btc": {
                      "type": "number",
                      "description": "Block subsidy after the next halving"
                    },
                    "blocks_remaining": {
                      "type": "number",
                      "description": "Blocks until the next halving"
                    },
                    "estimated_days_remaining": {
                      "type": "number",
                      "description": "Days until the next halving at the assumed block time"
                    },
                    "estimated_halving_date": {
                      "type": "string",
                      "description": "Estimated UTC time of the next halving"
                    },
                    "progress_through_era_percent": {
                      "type": "number",
                      "description": "How far through the current era the height is"
                    },
                    "supply_mined_btc": {
                      "type": "number",
                      "description": "Cumulative subsidy issued by this height"
                    },
                    "max_supply_btc": {
                      "type": "number",
                      "description": "Maximum bitcoin supply"
                    },
                    "subsidy_issued_per_day_btc": {
                      "type": "number",
                      "description": "New bitcoin issued per day at 144 blocks"
                    },
                    "note": {
                      "type": "string",
                      "description": "Plain-language caveat about how to read and use the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "Where the data or formula comes from"
                    },
                    "avg_block_minutes_assumed": {
                      "description": "Average block time assumed",
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "next_halving_height",
                    "estimated_halving_date"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/btc/halving?current_height=971900&as_of=2026-10-17",
        "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": {
    "current_height": 0,
    "current_era": 0,
    "current_subsidy_btc": 0,
    "next_halving_height": 0,
    "next_subsidy_btc": 0,
    "blocks_remaining": 0,
    "estimated_days_remaining": 0,
    "estimated_halving_date": "string",
    "progress_through_era_percent": 0,
    "supply_mined_btc": 0,
    "max_supply_btc": 0,
    "subsidy_issued_per_day_btc": 0,
    "note": "string",
    "source": "string",
    "avg_block_minutes_assumed": 0
  }
}