Skip to main content
GET
/
api
/
btc
/
chain
/
tip
Get chain tip
curl --request GET \
  --url https://nexus.gerowallet.io/api/btc/chain/tip \
  --header 'Authorization: Bearer <token>'
{
  "chain": "<string>",
  "blocks": 123,
  "headers": 123,
  "bestblockhash": "<string>",
  "time": 123,
  "difficulty": 123,
  "verificationprogress": 123,
  "initialblockdownload": true,
  "chainwork": "<string>",
  "pruned": true
}

Authorizations

​
Authorization
string
header
required

JWT Token Authentication

Query Parameters

​
network
enum<string>
Available options:
CARDANO_MAINNET,
CARDANO_PREPROD,
CARDANO_PREVIEW,
APEX_PRIME_MAINNET,
APEX_VECTOR_MAINNET,
APEX_VECTOR_TESTNET,
MIDNIGHT_MAINNET,
MIDNIGHT_PREPROD,
MIDNIGHT_PREVIEW,
BITCOIN_MAINNET,
BITCOIN_TESTNET4

Response

OK

Bitcoin chain tip and sync state

​
chain
string

Network identifier (main, test, signet, regtest, testnet4)

​
blocks
integer<int64>

Block height of the local best chain

​
headers
integer<int64>

Header height (may be ahead of blocks during sync)

​
bestblockhash
string

Best block hash

​
time
integer<int64>

Block timestamp at the tip (epoch seconds)

​
difficulty
number<double>

Difficulty at the tip

​
verificationprogress
number<double>

Estimated proportion of chain verified, 0..1

​
initialblockdownload
boolean

True while the node is in initial block download

​
chainwork
string

Cumulative chainwork as hex

​
pruned
boolean

Whether bitcoind is pruned