getchaintips | Alchemy Docs

Returns information about all known tips in the block tree, including the active chain tip and orphaned branches.

Path parameters

apiKeystringRequiredDefaults to docs-demo

Response

An array of chain tip information objects.

heightinteger

The height of the chain tip.

hashstring

The block hash of the chain tip.

branchleninteger

Length of the branch connecting the tip to the main chain (0 for main chain).

statusenum

Status of the chain tip: - active: tip of the main chain - valid-fork: fully validated but not active - valid-headers: headers valid but blocks not fully validated - headers-only: only headers are available - invalid: contains at least one invalid block

Allowed values:

1	import requests
2
3	url = "https://bitcoin-mainnet.g.alchemy.com/v2/:apiKey"
4
5	payload = {}
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())

1	{
2	"jsonrpc": "2.0",
3	"id": "1",
4	"result": [
5	{
6	"height": 894712,
7	"hash": "00000000000000000000e6518eac47199bcf0108b1c7d194b00ef5a9df794427",
8	"branchlen": 0,
9	"status": "active"
10	},
11	{
12	"height": 894657,
13	"hash": "00000000000000000002311b7c31f1ffef1261bb53740958ed98c600ae2abd41",
14	"branchlen": 1,
15	"status": "valid-fork"
16	}
17	]
18	}