Kaspa REST-API server

v1.0.0

Base URL

https://kas.nownodes.io

This server is to communicate with kaspa network via REST-API

Authentication

api-keyAuthapiKey

API Key: api-key in header

General

Addresses

Get Balance From Kaspa Address

GET

https://kas.nownodes.io/addresses/{kaspaAddress}/balance

Get balance for a given kaspa address

Parameters

kaspaAddressstringrequiredpath

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Balance From Kaspa Address

curl -X GET 'https://kas.nownodes.io/addresses/{kaspaAddress}/balance'

const response = await fetch('https://kas.nownodes.io/addresses/{kaspaAddress}/balance', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/{kaspaAddress}/balance')
data = response.json()

{
  "address": "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73",
  "balance": 38240000000
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Utxos For Address

GET

https://kas.nownodes.io/addresses/{kaspaAddress}/utxos

Lists all open utxo for a given kaspa address

Parameters

kaspaAddressstringrequiredpath

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Utxos For Address

curl -X GET 'https://kas.nownodes.io/addresses/{kaspaAddress}/utxos'

const response = await fetch('https://kas.nownodes.io/addresses/{kaspaAddress}/utxos', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/{kaspaAddress}/utxos')
data = response.json()

[
  {
    "address": "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73",
    "outpoint": {
      "transactionId": "ef62efbc2825d3ef9ec1cf9b80506876ac077b64b11a39c8ef5e028415444dc9",
      "index": 0
    },
    "utxoEntry": {
      "amount": [
        "11501593788"
      ],
      "scriptPublicKey": {
        "scriptPublicKey": "20c5629ce85f6618cd3ed1ac1c99dc6d3064ed244013555c51385d9efab0d0072fac"
      },
      "blockDaaScore": "18867232",
      "isCoinbase": false
    }
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Utxos For Addresses

POST

https://kas.nownodes.io/addresses/utxos

Lists all open utxo for a given kaspa address

Body

application/json

addressesArray<string>kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Utxos For Addresses

curl -X POST 'https://kas.nownodes.io/addresses/utxos' \
  -H 'Content-Type: application/json' \
  -d '{
    "addresses": [
      "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
    ]
  }'

const response = await fetch('https://kas.nownodes.io/addresses/utxos', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "addresses": [
        "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "addresses": [
    "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
  ]
}

response = requests.post('https://kas.nownodes.io/addresses/utxos', json=payload)
data = response.json()

Request Body

{
  "addresses": [
    "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
  ]
}

[
  {
    "address": "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73",
    "outpoint": {
      "transactionId": "ef62efbc2825d3ef9ec1cf9b80506876ac077b64b11a39c8ef5e028415444dc9",
      "index": 0
    },
    "utxoEntry": {
      "amount": [
        "11501593788"
      ],
      "scriptPublicKey": {
        "scriptPublicKey": "20c5629ce85f6618cd3ed1ac1c99dc6d3064ed244013555c51385d9efab0d0072fac"
      },
      "blockDaaScore": "18867232",
      "isCoinbase": false
    }
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Full Transactions For Address

GET

https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions

Get all transactions for a given address from database. And then get their related full transaction data

Parameters

kaspaAddressstringrequiredpath

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

limitinteger[1, 500]50query

The number of records to get

offsetinteger>= 00query

The offset from which to get records

fieldsstringquery

resolve_previous_outpointsPreviousOutpointLookupModenoquery

Use this parameter if you want to fetch the TransactionInput previous outpoint details. Light fetches only the adress and amount. Full fetches the whole TransactionOutput and adds it into each TxInput.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Full Transactions For Address

curl -X GET 'https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions'

const response = await fetch('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions')
data = response.json()

[
  {
    "subnetwork_id": "string",
    "transaction_id": "string",
    "hash": "string",
    "mass": "string",
    "payload": "string",
    "block_hash": [
      "string"
    ],
    "block_time": 0,
    "is_accepted": true,
    "accepting_block_hash": "string",
    "accepting_block_blue_score": 0,
    "accepting_block_time": 0,
    "inputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "previous_outpoint_hash": "string",
        "previous_outpoint_index": "string",
        "previous_outpoint_resolved": {
          "transaction_id": "string",
          "index": 0,
          "amount": 0,
          "script_public_key": "string",
          "script_public_key_address": "string",
          "script_public_key_type": "string",
          "accepting_block_hash": "string"
        },
        "previous_outpoint_address": "string",
        "previous_outpoint_amount": 0,
        "signature_script": "string",
        "sig_op_count": "string"
      }
    ],
    "outputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "accepting_block_hash": "string"
      }
    ]
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Addresses Active

POST

https://kas.nownodes.io/addresses/active

This endpoint checks if addresses have had any transaction activity in the past. It is specifically designed for HD Wallets to verify historical address activity.

Body

application/json

addressesArray<string>kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Addresses Active

curl -X POST 'https://kas.nownodes.io/addresses/active' \
  -H 'Content-Type: application/json' \
  -d '{
    "addresses": [
      "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
    ]
  }'

const response = await fetch('https://kas.nownodes.io/addresses/active', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "addresses": [
        "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "addresses": [
    "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
  ]
}

response = requests.post('https://kas.nownodes.io/addresses/active', json=payload)
data = response.json()

Request Body

{
  "addresses": [
    "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
  ]
}

[
  {
    "address": "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73",
    "active": true,
    "lastTxBlockTime": 1752924174352
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Full Transactions For Address Page

GET

https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page

Get all transactions for a given address from database. And then get their related full transaction data

Parameters

kaspaAddressstringrequiredpath

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

limitinteger[1, 500]50query

The max number of records to get. For paging combine with using 'before/after' from oldest previous result. Use value of X-Next-Page-Before/-After as long as header is present to continue paging. The actual number of transactions returned for each page can be > limit.

beforeinteger>= 00query

Only include transactions with block time before this (epoch-millis)

afterinteger>= 00query

Only include transactions with block time after this (epoch-millis)

fieldsstringquery

resolve_previous_outpointsPreviousOutpointLookupModenoquery

acceptanceAcceptanceModeacceptedrejectedquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Full Transactions For Address Page

curl -X GET 'https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page'

const response = await fetch('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page')
data = response.json()

[
  {
    "subnetwork_id": "string",
    "transaction_id": "string",
    "hash": "string",
    "mass": "string",
    "payload": "string",
    "block_hash": [
      "string"
    ],
    "block_time": 0,
    "is_accepted": true,
    "accepting_block_hash": "string",
    "accepting_block_blue_score": 0,
    "accepting_block_time": 0,
    "inputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "previous_outpoint_hash": "string",
        "previous_outpoint_index": "string",
        "previous_outpoint_resolved": {
          "transaction_id": "string",
          "index": 0,
          "amount": 0,
          "script_public_key": "string",
          "script_public_key_address": "string",
          "script_public_key_type": "string",
          "accepting_block_hash": "string"
        },
        "previous_outpoint_address": "string",
        "previous_outpoint_amount": 0,
        "signature_script": "string",
        "sig_op_count": "string"
      }
    ],
    "outputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "accepting_block_hash": "string"
      }
    ]
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Transaction Count For Address

GET

https://kas.nownodes.io/addresses/{kaspaAddress}/transactions-count

Count the number of transactions associated with this address

Parameters

kaspaAddressstringrequiredpath

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Transaction Count For Address

curl -X GET 'https://kas.nownodes.io/addresses/{kaspaAddress}/transactions-count'

const response = await fetch('https://kas.nownodes.io/addresses/{kaspaAddress}/transactions-count', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/{kaspaAddress}/transactions-count')
data = response.json()

{
  "total": 0,
  "limit_exceeded": true
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Addresses Names

GET

https://kas.nownodes.io/addresses/names

Get the name for an address

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Addresses Names

curl -X GET 'https://kas.nownodes.io/addresses/names'

const response = await fetch('https://kas.nownodes.io/addresses/names', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/names')
data = response.json()

200

[
  {
    "address": "string",
    "name": "string"
  }
]

Get Name For Address

GET

https://kas.nownodes.io/addresses/{kaspaAddress}/name

Get the name for an address

Parameters

kaspaAddressstringrequiredpath

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Name For Address

curl -X GET 'https://kas.nownodes.io/addresses/{kaspaAddress}/name'

const response = await fetch('https://kas.nownodes.io/addresses/{kaspaAddress}/name', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/addresses/{kaspaAddress}/name')
data = response.json()

{
  "address": "string",
  "name": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Balances From Addresses

POST

https://kas.nownodes.io/addresses/balances

Get balances for multiple Addresses

Body

application/json

addressesArray<string>kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Balances From Addresses

curl -X POST 'https://kas.nownodes.io/addresses/balances' \
  -H 'Content-Type: application/json' \
  -d '{
    "addresses": [
      "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
    ]
  }'

const response = await fetch('https://kas.nownodes.io/addresses/balances', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "addresses": [
        "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "addresses": [
    "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
  ]
}

response = requests.post('https://kas.nownodes.io/addresses/balances', json=payload)
data = response.json()

Request Body

{
  "addresses": [
    "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"
  ]
}

[
  {
    "address": "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73",
    "balance": 12451591699
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Info

Get Virtual Selected Parent Blue Score

GET

https://kas.nownodes.io/info/virtual-chain-blue-score

Returns the blue score of the sink

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Virtual Selected Parent Blue Score

curl -X GET 'https://kas.nownodes.io/info/virtual-chain-blue-score'

const response = await fetch('https://kas.nownodes.io/info/virtual-chain-blue-score', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/virtual-chain-blue-score')
data = response.json()

200

{
  "blueScore": 260890
}

Get Network

GET

https://kas.nownodes.io/info/network

Alias for /info/blockdag

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Network

curl -X GET 'https://kas.nownodes.io/info/network'

const response = await fetch('https://kas.nownodes.io/info/network', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/network')
data = response.json()

200

{
  "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

https://kas.nownodes.io/info/blockdag

Get Kaspa BlockDAG information

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Blockdag

curl -X GET 'https://kas.nownodes.io/info/blockdag'

const response = await fetch('https://kas.nownodes.io/info/blockdag', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/blockdag')
data = response.json()

200

{
  "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

https://kas.nownodes.io/info/coinsupply

Get $KAS coin supply information

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Coinsupply

curl -X GET 'https://kas.nownodes.io/info/coinsupply'

const response = await fetch('https://kas.nownodes.io/info/coinsupply', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/coinsupply')
data = response.json()

200

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

Get Circulating Coins

GET

https://kas.nownodes.io/info/coinsupply/circulating

Get circulating amount of $KAS token as numerical value

Parameters

in_billionbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Circulating Coins

curl -X GET 'https://kas.nownodes.io/info/coinsupply/circulating'

const response = await fetch('https://kas.nownodes.io/info/coinsupply/circulating', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/coinsupply/circulating')
data = response.json()

string

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Total Coins

GET

https://kas.nownodes.io/info/coinsupply/total

Get total amount of $KAS token as numerical value

Parameters

in_billionbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Total Coins

curl -X GET 'https://kas.nownodes.io/info/coinsupply/total'

const response = await fetch('https://kas.nownodes.io/info/coinsupply/total', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/coinsupply/total')
data = response.json()

string

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Kaspad Info

GET

https://kas.nownodes.io/info/kaspad

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

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Kaspad Info

curl -X GET 'https://kas.nownodes.io/info/kaspad'

const response = await fetch('https://kas.nownodes.io/info/kaspad', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/kaspad')
data = response.json()

200

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

Get Fee Estimate

GET

https://kas.nownodes.io/info/fee-estimate

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)

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Fee Estimate

curl -X GET 'https://kas.nownodes.io/info/fee-estimate'

const response = await fetch('https://kas.nownodes.io/info/fee-estimate', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/fee-estimate')
data = response.json()

200

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

Get Price

GET

https://kas.nownodes.io/info/price

Returns the current price for Kaspa in USD.

Parameters

stringOnlybooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Price

curl -X GET 'https://kas.nownodes.io/info/price'

const response = await fetch('https://kas.nownodes.io/info/price', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/price')
data = response.json()

{
  "price": 0.025235
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Blockreward

GET

https://kas.nownodes.io/info/blockreward

Returns the current blockreward in KAS/block

Parameters

stringOnlybooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Blockreward

curl -X GET 'https://kas.nownodes.io/info/blockreward'

const response = await fetch('https://kas.nownodes.io/info/blockreward', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/blockreward')
data = response.json()

{
  "blockreward": 12000132
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Halving

GET

https://kas.nownodes.io/info/halving

Returns information about chromatic halving

Parameters

fieldstringquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Halving

curl -X GET 'https://kas.nownodes.io/info/halving'

const response = await fetch('https://kas.nownodes.io/info/halving', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/halving')
data = response.json()

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

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Hashrate

GET

https://kas.nownodes.io/info/hashrate

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

Parameters

stringOnlybooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Hashrate

curl -X GET 'https://kas.nownodes.io/info/hashrate'

const response = await fetch('https://kas.nownodes.io/info/hashrate', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/hashrate')
data = response.json()

{
  "hashrate": 12000132
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Max Hashrate

GET

https://kas.nownodes.io/info/hashrate/max

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

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Get Max Hashrate

curl -X GET 'https://kas.nownodes.io/info/hashrate/max'

const response = await fetch('https://kas.nownodes.io/info/hashrate/max', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/hashrate/max')
data = response.json()

200

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

Get Hashrate History

GET

https://kas.nownodes.io/info/hashrate/history

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

Parameters

resolutionstring1h3h1d7dquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Hashrate History

curl -X GET 'https://kas.nownodes.io/info/hashrate/history'

const response = await fetch('https://kas.nownodes.io/info/hashrate/history', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/hashrate/history')
data = response.json()

[
  {
    "daaScore": 0,
    "blueScore": 0,
    "timestamp": 0,
    "date_time": "string",
    "bits": 0,
    "difficulty": 0,
    "hashrate_kh": 0
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Health State

GET

https://kas.nownodes.io/info/health

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.

Response

200OK

Successful Response

Authorization

api-keyAuthapiKey in header

Health State

curl -X GET 'https://kas.nownodes.io/info/health'

const response = await fetch('https://kas.nownodes.io/info/health', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/health')
data = response.json()

200

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

Get Marketcap

GET

https://kas.nownodes.io/info/marketcap

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

Parameters

stringOnlybooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Marketcap

curl -X GET 'https://kas.nownodes.io/info/marketcap'

const response = await fetch('https://kas.nownodes.io/info/marketcap', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/info/marketcap')
data = response.json()

{
  "marketcap": 12000132
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Blocks

Get Block

GET

https://kas.nownodes.io/blocks/{blockId}

Get block information for a given block id

Parameters

blockIdstringrequiredpath

includeTransactionsbooleantruequery

includeColorbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Block

curl -X GET 'https://kas.nownodes.io/blocks/{blockId}'

const response = await fetch('https://kas.nownodes.io/blocks/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/blocks/{blockId}')
data = response.json()

{
  "header": {
    "version": 1,
    "hashMerkleRoot": "e6641454e16cff4f232b899564eeaa6e480b66069d87bee6a2b2476e63fcd887",
    "acceptedIdMerkleRoot": "9bab45b027a0b2b47135b6f6f866e5e4040fc1fdf2fe56eb0c90a603ce86092b",
    "utxoCommitment": "236d5f9ffd19b317a97693322c3e2ae11a44b5df803d71f1ccf6c2393bc6143c",
    "timestamp": "1656450648874",
    "bits": 455233226,
    "nonce": "14797571275553019490",
    "daaScore": "19984482",
    "blueWork": "2d1b3f04f8a0dcd31",
    "parents": [
      {
        "parentHashes": [
          "580f65c8da9d436480817f6bd7c13eecd9223b37f0d34ae42fb17e1e9fda397e"
        ]
      }
    ],
    "blueScore": "18483232",
    "pruningPoint": "5d32a9403273a34b6551b84340a1459ddde2ae6ba59a47987a6374340ba41d5d"
  },
  "transactions": [
    {
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sigOpCount": 0,
          "sequence": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "scriptPublicKey": "string",
            "version": 0
          },
          "verboseData": {
            "scriptPublicKeyType": "string",
            "scriptPublicKeyAddress": "string"
          }
        }
      ],
      "subnetworkId": "string",
      "payload": "string",
      "verboseData": {
        "transactionId": "string",
        "hash": "string",
        "computeMass": 0,
        "blockHash": "string",
        "blockTime": 0
      },
      "lockTime": 0,
      "gas": 0,
      "mass": 0,
      "version": 0
    }
  ],
  "verboseData": {
    "hash": "18c7afdf8f447ca06adb8b4946dc45f5feb1188c7d177da6094dfbc760eca699",
    "difficulty": [
      4102204523252.94
    ],
    "selectedParentHash": "580f65c8da9d436480817f6bd7c13eecd9223b37f0d34ae42fb17e1e9fda397e",
    "transactionIds": [
      "533f8314bf772259fe517f53507a79ebe61c8c6a11748d93a0835551233b3311"
    ],
    "blueScore": "18483232",
    "childrenHashes": [
      "string"
    ],
    "mergeSetBluesHashes": [],
    "mergeSetRedsHashes": [],
    "isChainBlock": false
  },
  "extra": {
    "color": "string",
    "minerAddress": "string",
    "minerInfo": "string"
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Blocks

GET

https://kas.nownodes.io/blocks

Lists block beginning from a low hash (block id).

Parameters

lowHashstringrequiredquery

includeBlocksbooleanfalsequery

includeTransactionsbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Blocks

curl -X GET 'https://kas.nownodes.io/blocks'

const response = await fetch('https://kas.nownodes.io/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/blocks')
data = response.json()

{
  "blockHashes": [
    "44edf9bfd32aa154bfad64485882f184372b64bd60565ba121b42fc3cb1238f3",
    "18c7afdf8f447ca06adb8b4946dc45f5feb1188c7d177da6094dfbc760eca699",
    "9a822351cd293a653f6721afec1646bd1690da7124b5fbe87001711406010604",
    "2fda0dad4ec879b4ad02ebb68c757955cab305558998129a7de111ab852e7dcb"
  ],
  "blocks": [
    {
      "header": {
        "version": 1,
        "hashMerkleRoot": "e6641454e16cff4f232b899564eeaa6e480b66069d87bee6a2b2476e63fcd887",
        "acceptedIdMerkleRoot": "9bab45b027a0b2b47135b6f6f866e5e4040fc1fdf2fe56eb0c90a603ce86092b",
        "utxoCommitment": "236d5f9ffd19b317a97693322c3e2ae11a44b5df803d71f1ccf6c2393bc6143c",
        "timestamp": "1656450648874",
        "bits": 455233226,
        "nonce": "14797571275553019490",
        "daaScore": "19984482",
        "blueWork": "2d1b3f04f8a0dcd31",
        "parents": [
          {
            "parentHashes": [
              "580f65c8da9d436480817f6bd7c13eecd9223b37f0d34ae42fb17e1e9fda397e"
            ]
          }
        ],
        "blueScore": "18483232",
        "pruningPoint": "5d32a9403273a34b6551b84340a1459ddde2ae6ba59a47987a6374340ba41d5d"
      },
      "transactions": [
        {
          "inputs": [
            {
              "previousOutpoint": {
                "transactionId": "string",
                "index": 0
              },
              "signatureScript": "string",
              "sigOpCount": 0,
              "sequence": 0
            }
          ],
          "outputs": [
            {
              "amount": 0,
              "scriptPublicKey": {
                "scriptPublicKey": "string",
                "version": 0
              },
              "verboseData": {
                "scriptPublicKeyType": "string",
                "scriptPublicKeyAddress": "string"
              }
            }
          ],
          "subnetworkId": "string",
          "payload": "string",
          "verboseData": {
            "transactionId": "string",
            "hash": "string",
            "computeMass": 0,
            "blockHash": "string",
            "blockTime": 0
          },
          "lockTime": 0,
          "gas": 0,
          "mass": 0,
          "version": 0
        }
      ],
      "verboseData": {
        "hash": "18c7afdf8f447ca06adb8b4946dc45f5feb1188c7d177da6094dfbc760eca699",
        "difficulty": [
          4102204523252.94
        ],
        "selectedParentHash": "580f65c8da9d436480817f6bd7c13eecd9223b37f0d34ae42fb17e1e9fda397e",
        "transactionIds": [
          "533f8314bf772259fe517f53507a79ebe61c8c6a11748d93a0835551233b3311"
        ],
        "blueScore": "18483232",
        "childrenHashes": [
          "string"
        ],
        "mergeSetBluesHashes": [],
        "mergeSetRedsHashes": [],
        "isChainBlock": false
      },
      "extra": {
        "color": "string",
        "minerAddress": "string",
        "minerInfo": "string"
      }
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Blocks From Bluescore

GET

https://kas.nownodes.io/blocks-from-bluescore

Lists blocks of a given blueScore

Parameters

blueScoreinteger43679173query

includeTransactionsbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Blocks From Bluescore

curl -X GET 'https://kas.nownodes.io/blocks-from-bluescore'

const response = await fetch('https://kas.nownodes.io/blocks-from-bluescore', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/blocks-from-bluescore')
data = response.json()

[
  {
    "header": {
      "version": 1,
      "hashMerkleRoot": "e6641454e16cff4f232b899564eeaa6e480b66069d87bee6a2b2476e63fcd887",
      "acceptedIdMerkleRoot": "9bab45b027a0b2b47135b6f6f866e5e4040fc1fdf2fe56eb0c90a603ce86092b",
      "utxoCommitment": "236d5f9ffd19b317a97693322c3e2ae11a44b5df803d71f1ccf6c2393bc6143c",
      "timestamp": "1656450648874",
      "bits": 455233226,
      "nonce": "14797571275553019490",
      "daaScore": "19984482",
      "blueWork": "2d1b3f04f8a0dcd31",
      "parents": [
        {
          "parentHashes": [
            "580f65c8da9d436480817f6bd7c13eecd9223b37f0d34ae42fb17e1e9fda397e"
          ]
        }
      ],
      "blueScore": "18483232",
      "pruningPoint": "5d32a9403273a34b6551b84340a1459ddde2ae6ba59a47987a6374340ba41d5d"
    },
    "transactions": [
      {
        "inputs": [
          {
            "previousOutpoint": {
              "transactionId": "string",
              "index": 0
            },
            "signatureScript": "string",
            "sigOpCount": 0,
            "sequence": 0
          }
        ],
        "outputs": [
          {
            "amount": 0,
            "scriptPublicKey": {
              "scriptPublicKey": "string",
              "version": 0
            },
            "verboseData": {
              "scriptPublicKeyType": "string",
              "scriptPublicKeyAddress": "string"
            }
          }
        ],
        "subnetworkId": "string",
        "payload": "string",
        "verboseData": {
          "transactionId": "string",
          "hash": "string",
          "computeMass": 0,
          "blockHash": "string",
          "blockTime": 0
        },
        "lockTime": 0,
        "gas": 0,
        "mass": 0,
        "version": 0
      }
    ],
    "verboseData": {
      "hash": "18c7afdf8f447ca06adb8b4946dc45f5feb1188c7d177da6094dfbc760eca699",
      "difficulty": [
        4102204523252.94
      ],
      "selectedParentHash": "580f65c8da9d436480817f6bd7c13eecd9223b37f0d34ae42fb17e1e9fda397e",
      "transactionIds": [
        "533f8314bf772259fe517f53507a79ebe61c8c6a11748d93a0835551233b3311"
      ],
      "blueScore": "18483232",
      "childrenHashes": [
        "string"
      ],
      "mergeSetBluesHashes": [],
      "mergeSetRedsHashes": [],
      "isChainBlock": false
    },
    "extra": {
      "color": "string",
      "minerAddress": "string",
      "minerInfo": "string"
    }
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Transactions

Get Transaction

GET

https://kas.nownodes.io/transactions/{transactionId}

Get details for a given transaction id

Parameters

transactionIdstringrequiredpath

blockHashstringquery

Specify a containing block (if known) for faster lookup

inputsbooleantruequery

outputsbooleantruequery

resolve_previous_outpointsPreviousOutpointLookupModenoquery

Use this parameter if you want to fetch the TransactionInput previous outpoint details. Light fetches only the address and amount. Full fetches the whole TransactionOutput and adds it into each TxInput.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Transaction

curl -X GET 'https://kas.nownodes.io/transactions/{transactionId}'

const response = await fetch('https://kas.nownodes.io/transactions/{transactionId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/transactions/{transactionId}')
data = response.json()

{
  "subnetwork_id": "string",
  "transaction_id": "string",
  "hash": "string",
  "mass": "string",
  "payload": "string",
  "block_hash": [
    "string"
  ],
  "block_time": 0,
  "is_accepted": true,
  "accepting_block_hash": "string",
  "accepting_block_blue_score": 0,
  "accepting_block_time": 0,
  "inputs": [
    {
      "transaction_id": "string",
      "index": 0,
      "previous_outpoint_hash": "string",
      "previous_outpoint_index": "string",
      "previous_outpoint_resolved": {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "accepting_block_hash": "string"
      },
      "previous_outpoint_address": "string",
      "previous_outpoint_amount": 0,
      "signature_script": "string",
      "sig_op_count": "string"
    }
  ],
  "outputs": [
    {
      "transaction_id": "string",
      "index": 0,
      "amount": 0,
      "script_public_key": "string",
      "script_public_key_address": "string",
      "script_public_key_type": "string",
      "accepting_block_hash": "string"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Search For Transactions

POST

https://kas.nownodes.io/transactions/search

Search for transactions by transaction_ids or blue_score

Body

application/json

transactionIdsArray<string>

acceptingBlueScoresTxSearchAcceptingBlueScores

Show child attributes

gteintegerrequired

ltintegerrequired

Parameters

fieldsstringquery

resolve_previous_outpointsPreviousOutpointLookupModenoquery

acceptanceAcceptanceModequery

Only used when searching using transactionIds

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Search For Transactions

curl -X POST 'https://kas.nownodes.io/transactions/search' \
  -H 'Content-Type: application/json' \
  -d '{
    "transactionIds": [
      "string"
    ],
    "acceptingBlueScores": {
      "gte": 0,
      "lt": 0
    }
  }'

const response = await fetch('https://kas.nownodes.io/transactions/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transactionIds": [
        "string"
      ],
      "acceptingBlueScores": {
        "gte": 0,
        "lt": 0
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "transactionIds": [
    "string"
  ],
  "acceptingBlueScores": {
    "gte": 0,
    "lt": 0
  }
}

response = requests.post('https://kas.nownodes.io/transactions/search', json=payload)
data = response.json()

Request Body

{
  "transactionIds": [
    "string"
  ],
  "acceptingBlueScores": {
    "gte": 0,
    "lt": 0
  }
}

[
  {
    "subnetwork_id": "string",
    "transaction_id": "string",
    "hash": "string",
    "mass": "string",
    "payload": "string",
    "block_hash": [
      "string"
    ],
    "block_time": 0,
    "is_accepted": true,
    "accepting_block_hash": "string",
    "accepting_block_blue_score": 0,
    "accepting_block_time": 0,
    "inputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "previous_outpoint_hash": "string",
        "previous_outpoint_index": "string",
        "previous_outpoint_resolved": {
          "transaction_id": "string",
          "index": 0,
          "amount": 0,
          "script_public_key": "string",
          "script_public_key_address": "string",
          "script_public_key_type": "string",
          "accepting_block_hash": "string"
        },
        "previous_outpoint_address": "string",
        "previous_outpoint_amount": 0,
        "signature_script": "string",
        "sig_op_count": "string"
      }
    ],
    "outputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "accepting_block_hash": "string"
      }
    ]
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Transaction Acceptance

POST

https://kas.nownodes.io/transactions/acceptance

Given a list of transaction_ids, return whether each one is accepted and the accepting blue score.

Body

application/json

transactionIdsArray<string>required

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Transaction Acceptance

curl -X POST 'https://kas.nownodes.io/transactions/acceptance' \
  -H 'Content-Type: application/json' \
  -d '{
    "transactionIds": [
      "b9382bdee4aa364acf73eda93914eaae61d0e78334d1b8a637ab89ef5e224e41",
      "1e098b3830c994beb28768f7924a38286cec16e85e9757e0dc3574b85f624c34",
      "000ad5138a603aadc25cfcca6b6605d5ff47d8c7be594c9cdd199afa6dc76ac6"
    ]
  }'

const response = await fetch('https://kas.nownodes.io/transactions/acceptance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transactionIds": [
        "b9382bdee4aa364acf73eda93914eaae61d0e78334d1b8a637ab89ef5e224e41",
        "1e098b3830c994beb28768f7924a38286cec16e85e9757e0dc3574b85f624c34",
        "000ad5138a603aadc25cfcca6b6605d5ff47d8c7be594c9cdd199afa6dc76ac6"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "transactionIds": [
    "b9382bdee4aa364acf73eda93914eaae61d0e78334d1b8a637ab89ef5e224e41",
    "1e098b3830c994beb28768f7924a38286cec16e85e9757e0dc3574b85f624c34",
    "000ad5138a603aadc25cfcca6b6605d5ff47d8c7be594c9cdd199afa6dc76ac6"
  ]
}

response = requests.post('https://kas.nownodes.io/transactions/acceptance', json=payload)
data = response.json()

Request Body

{
  "transactionIds": [
    "b9382bdee4aa364acf73eda93914eaae61d0e78334d1b8a637ab89ef5e224e41",
    "1e098b3830c994beb28768f7924a38286cec16e85e9757e0dc3574b85f624c34",
    "000ad5138a603aadc25cfcca6b6605d5ff47d8c7be594c9cdd199afa6dc76ac6"
  ]
}

[
  {
    "transactionId": "b9382bdee4aa364acf73eda93914eaae61d0e78334d1b8a637ab89ef5e224e41",
    "accepted": true,
    "acceptingBlueScore": 0
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Submit A New Transaction

POST

https://kas.nownodes.io/transactions

Body

application/json

transactionSubmitTxModelrequired

Show child attributes

versionintegerrequired

inputsArray<SubmitTxInput>required

Show child attributes

previousOutpointSubmitTxOutpointrequired

Show child attributes

transactionIdstringrequired

indexintegerrequired

signatureScriptstringrequired

sequenceintegerrequired

sigOpCountintegerrequired

outputsArray<SubmitTxOutput>required

Show child attributes

amountintegerrequired

scriptPublicKeySubmitTxScriptPublicKeyrequired

Show child attributes

versionintegerrequired

scriptPublicKeystringrequired

lockTimeinteger0

subnetworkIdstring

allowOrphanbooleanfalse

Parameters

replaceByFeebooleanfalsequery

Replace an existing transaction in the mempool

Response

200OK

Successful Response

400Bad Request

Bad Request

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Submit A New Transaction

curl -X POST 'https://kas.nownodes.io/transactions' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": {
      "version": 0,
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sequence": 0,
          "sigOpCount": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "version": 0,
            "scriptPublicKey": "string"
          }
        }
      ],
      "lockTime": 0,
      "subnetworkId": "string"
    },
    "allowOrphan": false
  }'

const response = await fetch('https://kas.nownodes.io/transactions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": {
        "version": 0,
        "inputs": [
          {
            "previousOutpoint": {
              "transactionId": "string",
              "index": 0
            },
            "signatureScript": "string",
            "sequence": 0,
            "sigOpCount": 0
          }
        ],
        "outputs": [
          {
            "amount": 0,
            "scriptPublicKey": {
              "version": 0,
              "scriptPublicKey": "string"
            }
          }
        ],
        "lockTime": 0,
        "subnetworkId": "string"
      },
      "allowOrphan": false
    }),
});

const data = await response.json();

import requests

payload = {
  "transaction": {
    "version": 0,
    "inputs": [
      {
        "previousOutpoint": {
          "transactionId": "string",
          "index": 0
        },
        "signatureScript": "string",
        "sequence": 0,
        "sigOpCount": 0
      }
    ],
    "outputs": [
      {
        "amount": 0,
        "scriptPublicKey": {
          "version": 0,
          "scriptPublicKey": "string"
        }
      }
    ],
    "lockTime": 0,
    "subnetworkId": "string"
  },
  "allowOrphan": False
}

response = requests.post('https://kas.nownodes.io/transactions', json=payload)
data = response.json()

Request Body

{
  "transaction": {
    "version": 0,
    "inputs": [
      {
        "previousOutpoint": {
          "transactionId": "string",
          "index": 0
        },
        "signatureScript": "string",
        "sequence": 0,
        "sigOpCount": 0
      }
    ],
    "outputs": [
      {
        "amount": 0,
        "scriptPublicKey": {
          "version": 0,
          "scriptPublicKey": "string"
        }
      }
    ],
    "lockTime": 0,
    "subnetworkId": "string"
  },
  "allowOrphan": false
}

{
  "transactionId": "string",
  "error": "string"
}

{
  "transactionId": "string",
  "error": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Calculate Transaction Mass

POST

https://kas.nownodes.io/transactions/mass

This function calculates and returns the mass of a transaction, which is essential for determining the minimum fee. The mass calculation takes into account the storage mass as defined in KIP-0009.

Note: Be aware that if the transaction has a very low output amount or a high number of outputs, the mass can become significantly large.

Body

application/json

versionintegerrequired

inputsArray<SubmitTxInput>required

Show child attributes

previousOutpointSubmitTxOutpointrequired

Show child attributes

transactionIdstringrequired

indexintegerrequired

signatureScriptstringrequired

sequenceintegerrequired

sigOpCountintegerrequired

outputsArray<SubmitTxOutput>required

Show child attributes

amountintegerrequired

scriptPublicKeySubmitTxScriptPublicKeyrequired

Show child attributes

versionintegerrequired

scriptPublicKeystringrequired

lockTimeinteger0

subnetworkIdstring

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Calculate Transaction Mass

curl -X POST 'https://kas.nownodes.io/transactions/mass' \
  -H 'Content-Type: application/json' \
  -d '{
    "version": 0,
    "inputs": [
      {
        "previousOutpoint": {
          "transactionId": "string",
          "index": 0
        },
        "signatureScript": "string",
        "sequence": 0,
        "sigOpCount": 0
      }
    ],
    "outputs": [
      {
        "amount": 0,
        "scriptPublicKey": {
          "version": 0,
          "scriptPublicKey": "string"
        }
      }
    ],
    "lockTime": 0,
    "subnetworkId": "string"
  }'

const response = await fetch('https://kas.nownodes.io/transactions/mass', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "version": 0,
      "inputs": [
        {
          "previousOutpoint": {
            "transactionId": "string",
            "index": 0
          },
          "signatureScript": "string",
          "sequence": 0,
          "sigOpCount": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "version": 0,
            "scriptPublicKey": "string"
          }
        }
      ],
      "lockTime": 0,
      "subnetworkId": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "version": 0,
  "inputs": [
    {
      "previousOutpoint": {
        "transactionId": "string",
        "index": 0
      },
      "signatureScript": "string",
      "sequence": 0,
      "sigOpCount": 0
    }
  ],
  "outputs": [
    {
      "amount": 0,
      "scriptPublicKey": {
        "version": 0,
        "scriptPublicKey": "string"
      }
    }
  ],
  "lockTime": 0,
  "subnetworkId": "string"
}

response = requests.post('https://kas.nownodes.io/transactions/mass', json=payload)
data = response.json()

Request Body

{
  "version": 0,
  "inputs": [
    {
      "previousOutpoint": {
        "transactionId": "string",
        "index": 0
      },
      "signatureScript": "string",
      "sequence": 0,
      "sigOpCount": 0
    }
  ],
  "outputs": [
    {
      "amount": 0,
      "scriptPublicKey": {
        "version": 0,
        "scriptPublicKey": "string"
      }
    }
  ],
  "lockTime": 0,
  "subnetworkId": "string"
}

{
  "mass": 0,
  "storage_mass": 0,
  "compute_mass": 0
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Virtual chain

Get Virtual Chain Transactions

GET

https://kas.nownodes.io/virtual-chain

EXPERIMENTAL - EXPECT BREAKING CHANGES: Get virtual chain transactions by blue score.

Parameters

blueScoreGteinteger>= 0requiredquery

Divisible by limit

limitinteger1010010query

resolveInputsbooleanfalsequery

includeCoinbasebooleantruequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Authorization

api-keyAuthapiKey in header

Get Virtual Chain Transactions

curl -X GET 'https://kas.nownodes.io/virtual-chain'

const response = await fetch('https://kas.nownodes.io/virtual-chain', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://kas.nownodes.io/virtual-chain')
data = response.json()

[
  {
    "hash": "string",
    "blue_score": 0,
    "daa_score": 0,
    "timestamp": 0,
    "transactions": [
      {
        "transaction_id": "string",
        "is_accepted": true,
        "inputs": [
          {
            "previous_outpoint_hash": "string",
            "previous_outpoint_index": 0,
            "previous_outpoint_script": "string",
            "previous_outpoint_address": "string",
            "previous_outpoint_amount": 0
          }
        ],
        "outputs": [
          {
            "script_public_key": "string",
            "script_public_key_address": "string",
            "amount": 0
          }
        ]
      }
    ]
  }
]

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Documentation

Authentication

General

Addresses

Parameters

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

Info

Response

Authorization

Response

Authorization

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Blocks

Parameters

Response

Authorization

Parameters

Response