Get burn block

Retrieves a single burn block.

GET
/extended/v2/burn-blocks/{height_or_hash}

Path Parameters

height_or_hashstring & Burn block hash & Burn block height

Response Body

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

burn_block_timeinteger

Unix timestamp (in seconds) indicating when this block was mined.

burn_block_time_isostring

An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) indicating when this block was mined.

burn_block_hashstring

Hash of the anchor chain block

burn_block_heightinteger

Height of the anchor chain block

stacks_blocksarray<string>

Hashes of the Stacks blocks included in the burn block

avg_block_timeinteger

Average time between blocks in seconds. Returns 0 if there is only one block in the burn block.

total_tx_countinteger

Total number of transactions in the Stacks blocks associated with this burn block

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring
message?string
[key: string]any
curl -X GET "https://api.hiro.so//extended/v2/burn-blocks/latest"
fetch("https://api.hiro.so//extended/v2/burn-blocks/latest")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//extended/v2/burn-blocks/latest"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//extended/v2/burn-blocks/latest"

response = requests.request("GET", url)

print(response.text)
{
  "burn_block_time": 0,
  "burn_block_time_iso": "string",
  "burn_block_hash": "string",
  "burn_block_height": 0,
  "stacks_blocks": [
    "string"
  ],
  "avg_block_time": 0,
  "total_tx_count": 0
}
{
  "error": "string",
  "message": "string"
}