Links

getchaintips

Return information about all known tips in the block tree, including the main chain as well as orphaned branches.
Result
[ (json array)
{ (json object)
"height" : n, (numeric) height of the chain tip
"hash" : "hex", (string) block hash of the tip
"branchlen" : n, (numeric) zero for main chain, otherwise length of branch connecting the tip to the main chain
"status" : "str" (string) status of the chain, "active" for the main chain
Possible values for status:
1. "invalid" This branch contains at least one invalid block
2. "headers-only" Not all blocks for this branch are available, but the headers are valid
3. "valid-headers" All blocks are available for this branch, but they were never fully validated
4. "valid-fork" This branch is not part of the active chain, but is fully validated
5. "active" This is the tip of the active main chain, which is certainly valid
},
...
]
Request
Curl
Postman
curl --location --request POST 'https://btc.api.watchdata.io/node/jsonrpc?api_key=your_api_key' \
--header 'x-api-key: your_api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getchaintips",
"params": []
}'
URL: https://btc.api.watchdata.io/node/jsonrpc?api_key=your_api_key
RequestType: POST
Body:
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getchaintips",
"params": []
}
Response
[
{
"height": 736664,
"hash": "00000000000000000002412a773c2c03a7848722c15ec346598ba8ce7246f9fc",
"branchlen": 0,
"status": "active"
},
{
"height": 730848,
"hash": "000000000000000000029ec31578132d01696910f299f8d104f29b8f8bbdc24f",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 723102,
"hash": "00000000000000000006a970fdd8e537521747aff917d909bf3a78b4b68143e1",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 715276,
"hash": "00000000000000000009b160476c5f407ccd4957e20346b862d8fc46004759f0",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 715139,
"hash": "0000000000000000000407bc4e26035c137869cdb677dfcab268b3faf7d7b5d1",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 714637,
"hash": "00000000000000000009f819d004fea5bcb77bda25f4906d0a39e79c9ba19590",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 714367,
"hash": "0000000000000000000b2e70d7675bc7b4e89d384d0e6e1a7ecc2779e1d93244",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 710226,
"hash": "0000000000000000000299304196510f9f40d0e640a94258a473009efe587516",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 708426,
"hash": "0000000000000000000a5ee4cbb64a5e1496d6840b4744ecf3b559449a96148c",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 706409,
"hash": "0000000000000000000d6d4a65126b6e5c8cd9edf65b332f2f6a5189f9e800b6",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 705970,
"hash": "00000000000000000002328fe71f98eff128c9566bbf344d76234570b4a96e69",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 697008,
"hash": "000000000000000000077247c3ca9bae18511418667c4562fc6f92477b5d339e",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 696145,
"hash": "00000000000000000007c8948e5a89cd01804b7e5c6f454597c49d5b3b368b66",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 694157,
"hash": "00000000000000000006e24bdc5c1875fa40909ace270fb2b8756ac652ede82d",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 693118,
"hash": "00000000000000000011563e0ffef300d61465d69c92875e510050fc332bbe99",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 692894,
"hash": "00000000000000000007b160fdec44c7a20d01bcfe9ac0b46a3a897359fb1d69",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 685135,
"hash": "00000000000000000001737a81638210d3181d3469fa280959cdeb0514bb3d32",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 685036,
"hash": "000000000000000000058a8ff07f4aacfb1f20ca8482547fdba73ab9bef70b3e",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 683862,
"hash": "0000000000000000000ac05c6cccccb53afe71b1462c34371af22d56eda96550",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 679823,
"hash": "000000000000000000000f0d7742e6cd22da819b59af361224f452baee8d31c4",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 677102,
"hash": "000000000000000000044dfef81ca818882c24cdfb3178dd183ec7f9817b3fa1",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 676653,
"hash": "000000000000000000013acb9bf5bec0d7cc1a1f697686b5895e539399c8e72b",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 675815,
"hash": "000000000000000000052677c72ed5786a84fc841125b207e68410fb5084032b",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 675407,
"hash": "00000000000000000006e2aca3e49d3314782aac196548f8cfe12c34b98c8934",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 675392,
"hash": "0000000000000000000c64c3eb0e99f14024ca84ccdefc8d01aaf4aa5fadbafa",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 671759,
"hash": "00000000000000000002ebd581ecbbf98fe96290a9481254ef9fe0eeea569f7c",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 671646,
"hash": "000000000000000000040e2e14931819cd282023c46c4e19ecc2f9daa36f6eaa",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 671511,
"hash": "000000000000000000031dbcad41bafe1756aaeb7eddc243625d3627dba023ef",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 667881,
"hash": "0000000000000000000a2ae23d56ad7bdb31104e9b6b2cdc737db9a3fe325092",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 666833,
"hash": "00000000000000000005e086e9e74aae37139ba27c5ba8b50ba5c773e22c6b61",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 665005,
"hash": "00000000000000000001039fa3b04eb66a658c44632ac1d3694f772ea50f865f",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 664578,
"hash": "0000000000000000000cd89993f89e1414de84169914b487f49d1d0131ac5d62",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 663043,
"hash": "000000000000000000019a6273252cd334c21baf6cbf727bb3d3e23fe44dbaf1",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 662642,
"hash": "0000000000000000000c7af1e0b2172f1eed6b4d0707ea135c267ba263c7acf1",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 661983,
"hash": "00000000000000000006d890e1147294bf6d34bff9028d0567f2d48105c7b56a",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 656478,
"hash": "00000000000000000005f8f74e57aa4584aacfed509b8a6feb20bc22e7d60a34",
"branchlen": 2,
"status": "valid-headers"
},
{
"height": 654683,
"hash": "0000000000000000000a872e5cbdf79938b7fbf429cb63421112a8e919600c3d",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 650491,
"hash": "00000000000000000007a7691b799d895602ce6b1ccd303c6446703a41e6d6de",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 650473,
"hash": "0000000000000000000dba80455fcb5a8f9716375845f295dd755edb29e32fd8",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 648790,
"hash": "0000000000000000000e2cfa23d34bdf1485fcdfdb60e7bff9da95d03a9e18cb",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 645179,
"hash": "00000000000000000004c1baa2412fd31eb75bbe79def4f66ef97e0e15a20668",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 644543,
"hash": "0000000000000000000ac8d61492ab76dab7451373c6eaa6803ec0244f623395",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 643109,
"hash": "0000000000000000000d2f399065ee9be3150a37fd6c9ee1676a7688862ae2fd",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 642589,
"hash": "00000000000000000000aae7c05b5d930e479f462e9f905c5dc21557bd4a0d0a",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 638519,
"hash": "00000000000000000011398b899fb881c61bd6e8670270fbc8e225c11fd95d26",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 637110,
"hash": "0000000000000000000aa0415a6efa13adfb092c3af3bdce80b0db19af69a491",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 635366,
"hash": "0000000000000000000e83ae1e2f069094cc1deab4aede641e028df3c8507b41",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 633898,
"hash": "00000000000000000006e4f72bf9dda0ee692a4f36bc3562eeae3c259ea449e6",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 626037,
"hash": "00000000000000000001f905ed555d9024c3c846624992d1c3db29cef59323a4",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 623220,
"hash": "0000000000000000000d6502316008e4aaffe4ff786914d1851da5ae148083db",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 619970,
"hash": "000000000000000000110b16b926a38efa1343afd42fc92bc84fcfaa7b20dff5",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 478576,
"hash": "000000000000000001416af072f8989829f4c60a1a9658e1cec08411798e4ffa",
"branchlen": 18,
"status": "headers-only"
}
]