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

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": []
}'

Postman

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"
    }
]