Info

Get Virtual Selected Parent Blue Score

get

Returns the blue score of the sink

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/virtual-chain-blue-score HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "blueScore": 260890
}

Get Network

get

Alias for /info/blockdag

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/network HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "networkName": "kaspa-mainnet",
  "blockCount": "260890",
  "headerCount": "2131312",
  "tipHashes": [
    "78273854a739e3e379dfd34a262bbe922400d8e360e30e3f31228519a334350a"
  ],
  "difficulty": 3870677677777.2,
  "pastMedianTime": "1656455670700",
  "virtualParentHashes": [
    "78273854a739e3e379dfd34a262bbe922400d8e360e30e3f31228519a334350a"
  ],
  "pruningPointHash": "5d32a9403273a34b6551b84340a1459ddde2ae6ba59a47987a6374340ba41d5d",
  "virtualDaaScore": "19989141",
  "sink": "366b1cf51146cc002672b79948634751a2914a2cc9e273afe358bdc1ae19dce9"
}

Get Blockdag

get

Get Kaspa BlockDAG information

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/blockdag HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "networkName": "kaspa-mainnet",
  "blockCount": "260890",
  "headerCount": "2131312",
  "tipHashes": [
    "78273854a739e3e379dfd34a262bbe922400d8e360e30e3f31228519a334350a"
  ],
  "difficulty": 3870677677777.2,
  "pastMedianTime": "1656455670700",
  "virtualParentHashes": [
    "78273854a739e3e379dfd34a262bbe922400d8e360e30e3f31228519a334350a"
  ],
  "pruningPointHash": "5d32a9403273a34b6551b84340a1459ddde2ae6ba59a47987a6374340ba41d5d",
  "virtualDaaScore": "19989141",
  "sink": "366b1cf51146cc002672b79948634751a2914a2cc9e273afe358bdc1ae19dce9"
}

Get Coinsupply

get

Get $KAS coin supply information

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/coinsupply HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "circulatingSupply": "1000900697580640180",
  "maxSupply": "2900000000000000000"
}

Get Circulating Coins

get

Get circulating amount of $KAS token as numerical value

Authorizations
Query parameters
in_billionbooleanOptionalDefault: false
Responses
200
Successful Response
text/plain
Responsestring
get
GET /info/coinsupply/circulating HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

text

Get Total Coins

get

Get total amount of $KAS token as numerical value

Authorizations
Query parameters
in_billionbooleanOptionalDefault: false
Responses
200
Successful Response
text/plain
Responsestring
get
GET /info/coinsupply/total HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

text

Get Kaspad Info

get

Get some information for kaspad instance, which is currently connected.

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/kaspad HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "mempoolSize": "1",
  "serverVersion": "0.12.2",
  "isUtxoIndexed": true,
  "isSynced": true,
  "p2pIdHashed": "36a17cd8644eef34fc7fe4719655e06dbdf117008900c46975e66c35acd09b01"
}

Get Fee Estimate

get

Get fee estimate from Kaspad.

For all buckets, feerate values represent fee/mass of a transaction in sompi/gram units. Given a feerate value recommendation, calculate the required fee by taking the transaction mass and multiplying it by feerate: fee = feerate * mass(tx)

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/fee-estimate HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "priorityBucket": {
    "feerate": 1,
    "estimatedSeconds": 0.004
  },
  "normalBuckets": [
    {
      "feerate": 1,
      "estimatedSeconds": 0.004
    }
  ],
  "lowBuckets": [
    {
      "feerate": 1,
      "estimatedSeconds": 0.004
    }
  ]
}

Get Price

get

Returns the current price for Kaspa in USD.

Authorizations
Query parameters
stringOnlybooleanOptionalDefault: false
Responses
200
Successful Response
application/json
Responseany of
or
stringOptional
get
GET /info/price HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "price": 0.025235
}

Get Blockreward

get

Returns the current blockreward in KAS/block

Authorizations
Query parameters
stringOnlybooleanOptionalDefault: false
Responses
200
Successful Response
application/json
Responseany of
or
stringOptional
get
GET /info/blockreward HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "blockreward": 12000132
}

Get Halving

get

Returns information about chromatic halving

Authorizations
Query parameters
fieldstringOptional
Responses
200
Successful Response
application/json
Responseany of
or
stringOptional
get
GET /info/halving HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "nextHalvingTimestamp": 1662837270000,
  "nextHalvingDate": "2022-09-10 19:38:52 UTC",
  "nextHalvingAmount": 155.123123
}

Get Hashrate

get

Returns the current hashrate for Kaspa network in TH/s.

Authorizations
Query parameters
stringOnlybooleanOptionalDefault: false
Responses
200
Successful Response
application/json
Responseany of
or
stringOptional
get
GET /info/hashrate HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "hashrate": 12000132
}

Get Max Hashrate

get

Returns the current hashrate for Kaspa network in TH/s.

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/hashrate/max HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "hashrate": 12000132,
  "blockheader": {
    "hash": "e6641454e16cff4f232b899564eeaa6e480b66069d87bee6a2b2476e63fcd887",
    "timestamp": "1656450648874",
    "difficulty": 1212312312,
    "daaScore": "19984482",
    "blueScore": "18483232"
  }
}

Get Hashrate History

get

Get historical hashrate samples with optional resolution (default = 1h)

Authorizations
Query parameters
resolutionstring · enumOptionalPossible values:
Responses
200
Successful Response
application/json
get
GET /info/hashrate/history HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

[
  {
    "daaScore": 1,
    "blueScore": 1,
    "timestamp": 1,
    "date_time": "text",
    "bits": 1,
    "difficulty": 1,
    "hashrate_kh": 1
  }
]

Health State

get

Checks node and database health by comparing blue score and sync status. Returns health details or 503 if the database lags by ~10min or no nodes are synced.

Authorizations
Responses
200
Successful Response
application/json
get
GET /info/health HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
200

Successful Response

{
  "kaspadServers": [
    {
      "kaspadHost": "text",
      "serverVersion": "0.12.6",
      "isUtxoIndexed": true,
      "isSynced": true,
      "p2pId": "1231312",
      "blueScore": 0
    }
  ],
  "database": {
    "isSynced": true,
    "blueScore": 1,
    "blueScoreDiff": 1,
    "acceptedTxBlockTime": 1,
    "acceptedTxBlockTimeDiff": 1
  }
}

Get Marketcap

get

Get $KAS price and market cap. Price info is from coingecko.com

Authorizations
Query parameters
stringOnlybooleanOptionalDefault: false
Responses
200
Successful Response
application/json
Responseany of
or
stringOptional
get
GET /info/marketcap HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "marketcap": 12000132
}
PreviousAddressesNextBlocks