Chain Info

Get Blockchain Info

This endpoint retrieves information about the state of the specified chain for the selected network.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/chain/info

Example Request

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/chain/info"

Example Response

{
    "chain": "main",
    "blocks": 905064,
    "headers": 905064,
    "bestblockhash": "0000000000000000112ea3732c0417a2cee0130e9217dbba1b0ff078c92c904e",
    "difficulty": 51223782275.04099,
    "mediantime": 1752242156,
    "verificationprogress": 0.9999990488341951,
    "pruned": false,
    "chainwork": "00000000000000000000000000000000000000000167559704876ce49d636d35"
}

{
    "chain": "main",
    "blocks": 904937,
    "headers": 904937,
    "bestblockhash": "000000000000000000005c486692de6f8726bd9223bf4a2f80babedff0d44a91",
    "difficulty": 116958512019762.1,
    "mediantime": 1752160121,
    "verificationprogress": 0.9999988962482643,
    "pruned": false,
    "chainwork": "0000000000000000000000000000000000000000d12c110e37cfdb5d73cdd4ec",
    "size_on_disk": 763791035344
}

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

network

Selected network: main or test.

Get Circulating Supply

This endpoint retrieves the circulating supply of the specified blockchain.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/circulatingsupply

Example Request

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/circulatingsupply"

Example Response

19890434.375

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

network

Selected network: main or test.

Get Chain Tips

This endpoint retrieves information about all known tips in the block tree.

The possible values for status:

invalid: This branch contains at least one invalid block.
headers-only: Not all blocks for this branch are available, but the headers are valid.
valid-headers: All blocks are available for this branch, but they were never fully validated.
valid-fork: This branch is not part of the active chain, but is fully validated.
active: This is the tip of the active main chain, which is certainly valid.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/chain/tips

Example Request

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/chain/tips"

Example Response

[{
    "height": 905064,
    "hash": "0000000000000000112ea3732c0417a2cee0130e9217dbba1b0ff078c92c904e",
    "branchlen": 0,
    "status": "active"
}, {
    "height": 905048,
    "hash": "0000000000000000089a618e0f8b8fa5dcc8a201211d09aea1434a1e03c357cf",
    "branchlen": 1,
    "status": "valid-headers"
},
 ...
]

[{
    "height": 905086,
    "hash": "0000000000000000000061958ebfa47a17b104af4cf77cd0f23141748397d505",
    "branchlen": 0,
    "status": "active"
}, {
    "height": 904623,
    "hash": "00000000000000000002274bf6db24519f56a7d6b4841f216cb82e7dc345b499",
    "branchlen": 1,
    "status": "valid-fork"
},
...
]

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

network

Selected network: main or test.

Get Peer Info

This endpoint retrieves information about peers connected to the node.

HTTP Request

GET https://api.whatsonchain.com/v1/<chain>/<network>/peer/info

Example Request

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/peer/info"

Example Response

[{
    "id": 14,
    "addr": "78.110.160.26:56514",
    "addrlocal": "135.181.137.155:8333",
    "services": "0000000000000021",
    "relaytxes": true,
    "lastsend": 1752244985,
    "lastrecv": 1752244982,
    "bytessent": 9198799,
    "bytesrecv": 1112300,
    "conntime": 1752211964,
    "timeoffset": -58,
    "pingtime": 0.042279,
    "minping": 0.039421,
    "version": 70016,
    "subver": "/Bitcoin SV:1.0.16/",
    "inbound": true,
    "addnode": false,
    "startingheight": 905015,
    "txninvsize": 0,
    "banscore": 0,
    "synced_headers": 905064,
    "synced_blocks": 905064,
    "whitelisted": false,
    "bytessent_per_msg": {
        "addr": 27507,
        "blocktxn": 0,
        "cmpctblock": 0,
        "feefilter": 0,
        "getaddr": 0,
        "getdata": 0,
        "getheaders": 1053,
        "headers": 954,
        "inv": 3158821,
        "notfound": 0,
        "ping": 8832,
        "pong": 8832,
        "reject": 0,
        "sendcmpct": 33,
        "sendheaders": 24,
        "tx": 5992415,
        "verack": 24,
        "version": 146
    },
    "bytesrecv_per_msg": {
        "addr": 55,
        "blocktxn": 0,
        "cmpctblock": 0,
        "feefilter": 0,
        "getaddr": 24,
        "getdata": 109395,
        "getheaders": 1053,
        "headers": 4801,
        "inv": 978214,
        "notfound": 0,
        "ping": 8832,
        "pong": 8832,
        "reject": 694,
        "sendcmpct": 33,
        "sendheaders": 24,
        "tx": 0,
        "verack": 24,
        "version": 147
    }
},
...
]

[{
    "id": 19,
    "addr": "192.53.168.227:14985",
    "addrlocal": "65.108.123.176:44132",
    "services": "0000000000000c09",
    "relaytxes": false,
    "lastsend": 1752244946,
    "lastrecv": 1752244946,
    "bytessent": 3247905,
    "bytesrecv": 2058824,
    "conntime": 1749118420,
    "timeoffset": 0,
    "pingtime": 0.319371,
    "version": 70016,
    "subver": "/Satoshi:28.1.0/",
    "inbound": false,
    "startingheight": 899889,
    "banscore": 0,
    "feefilter": 0,
    "syncnode": false,
    "v2_connection": false
}, {
    "id": 26,
    "addr": "176.9.38.204:8333",
    "addrlocal": "65.108.123.176:58004",
    "services": "000000000000040d",
    "relaytxes": true,
    "lastsend": 1752245027,
    "lastrecv": 1752245028,
    "bytessent": 1042075735,
    "bytesrecv": 520385665,
    "conntime": 1749119628,
    "timeoffset": -1,
    "pingtime": 4.409384,
    "version": 70015,
    "subver": "/Satoshi:0.18.1/",
    "inbound": false,
    "startingheight": 899889,
    "banscore": 0,
    "feefilter": 0,
    "syncnode": false,
    "v2_connection": false
},
...
]

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

network

Selected network: main or test.

Last updated 5 months ago

Was this helpful?