Get Block Information
This endpoint allows you to fetch detailed information about a specific block using its height.
Endpoint
- Mainnet
- Testnet
GET https://api.spacescan.io/block/{block_height}
GET https://api-testnet11.spacescan.io/block/{block_height}
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| block_height | string | Yes | The height of the block to fetch |
Free API
Use api.spacescan.io for free tier access. See our API Plans for rate limits and features.
Pro API
Use pro-api.spacescan.io with your API key in the x-api-key header. See our API Plans for details.
curl -X GET "https://pro-api.spacescan.io/block/{block_height}" \
-H "x-api-key: YOUR_API_KEY"
Live API Test
- Mainnet
Request Examples
- cURL
- Python
- JavaScript
curl -X GET "https://api.spacescan.io/block/6555398"
import requests
block_height = "6555398"
url = f"https://api.spacescan.io/block/{block_height}"
response = requests.get(url)
data = response.json()
print(data)
const blockHeight = "6555398";
const url = `https://api.spacescan.io/block/${blockHeight}`;
fetch(url)
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Response Schema
| Field | Type | Description |
|---|---|---|
| number | string | Block height |
| hash | string | Hash of the block |
| type | string | Type of block ("Transaction block" or "Non Transaction block") |
| timestamp | string | Timestamp of block creation (nullable) |
| farmer_address | string | Address of the farmer who created the block |
| pool_address | string | Address of the pool |
| plot | string | Plot size used (e.g., "K32") |
| block_reward | number | Total block reward |
| pool_amount | number | Amount rewarded to pool |
| farmer_amount | number | Amount rewarded to farmer |
| transferred_amount | number | Total amount transferred in the block |
| addition_count | number | Number of coin additions |
| removal_count | number | Number of coin removals |
| reward_count | number | Number of rewards |
Example Response
{
"number": "6555398",
"hash": "0xb19a4d7fb21b7b92c890c294f6132bfbb059ff7bb713f211d4b18e4204ef18e5",
"type": "Non Transaction block",
"timestamp": null,
"farmer_address": "xch17yszydqqpqd5kk9c86hah7jndvcxcp2u2mhxfyvzf6gucp0c3pzszy8jde",
"pool_address": "xch182d6s8mf82k9hfmmc8jzla2lmfxt426830d3xq44l0ny8x8jwtxswru4he",
"plot": "K32",
"block_reward": 1,
"pool_amount": 0.875,
"farmer_amount": 0.125,
"transferred_amount": 0,
"addition_count": 0,
"removal_count": 0,
"reward_count": 0
}
Response Headers
| Header | Description |
|---|---|
| Content-Type | application/json |
| Cache-Control | Caching directives for the response |
Error Responses
| HTTP Status Code | Meaning |
|---|---|
| 400 | Bad Request -- Invalid block height |
| 404 | Not Found -- Block not found |
| 429 | Too Many Requests -- You're requesting too many times |
| 500 | Internal Server Error -- We had a problem with our server |
| 503 | Service Unavailable -- We're temporarily offline for maintenance |
Notes
- Block rewards are denominated in XCH
- The timestamp may be null for non-transaction blocks
- Addition and removal counts indicate transaction activity
- Reward count shows the number of reward-related transactions