Kaspa REST-API server 2.1.6 to 2.3.0 API CHANGES

v1.0.0

Base URL

https://kas.nownodes.io

This page lists what changed in the Kaspa REST API between server versions 2.1.6 and 2.3.0. Only changed methods are listed. Everything not mentioned here works exactly as described in the main Kaspa REST-API server reference. No method was added or removed in these releases.

Changed

block_hash of a transaction now contains exactly one block hash instead of every block the transaction was included in. Which one is returned is not defined, so it must not be treated as the only block that carries the transaction. If your integration relies on the full list, this is the change to look at.
Transaction inputs carry two new fields: compute_budget and covenant_id.
Transaction outputs carry two new fields: covenant_authorizing_input and covenant_id, and no longer carry accepting_block_hash. The transaction-level accepting_block_hash is not affected and is still returned.
In block transactions, inputs carry the new computeBudget field and outputs carry the new covenant object.

Affected methods:

GET /transactions/{transactionId}
POST /transactions/search
GET /addresses/{kaspaAddress}/full-transactions
GET /addresses/{kaspaAddress}/full-transactions-page
GET /blocks/{blockId}
GET /blocks
GET /blocks-from-bluescore

About the new fields

The new fields are filled in only for the transactions that use these features. Everywhere else they come back as null, but the keys themselves are always present, so a client that parses responses strictly should be ready for them.

Authentication

api-keyAuthapiKey

API Key: api-key in header

REST API changelog 2.1.6 to 2.3.0

Addresses

Get Full Transactions For Address

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. block_hash now contains exactly one block hash instead of every block the transaction was included in. Inputs carry the new compute_budget and covenant_id; outputs carry the new covenant_authorizing_input and covenant_id and no longer carry accepting_block_hash. The new fields are filled in only for the transactions that use these features, otherwise they are null.

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

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

[
  {
    "subnetwork_id": "string",
    "transaction_id": "string",
    "hash": "string",
    "mass": "string",
    "payload": "string",
    "block_hash": [
      "string"
    ],
    "block_time": 0,
    "version": 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",
          "covenant_authorizing_input": 0,
          "covenant_id": "string"
        },
        "previous_outpoint_address": "string",
        "previous_outpoint_amount": 0,
        "signature_script": "string",
        "sig_op_count": "string",
        "compute_budget": 0,
        "covenant_id": "string"
      }
    ],
    "outputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "covenant_authorizing_input": 0,
        "covenant_id": "string"
      }
    ]
  }
]

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

Get Full Transactions For Address Page

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

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

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/addresses/{kaspaAddress}/full-transactions-page')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

[
  {
    "subnetwork_id": "string",
    "transaction_id": "string",
    "hash": "string",
    "mass": "string",
    "payload": "string",
    "block_hash": [
      "string"
    ],
    "block_time": 0,
    "version": 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",
          "covenant_authorizing_input": 0,
          "covenant_id": "string"
        },
        "previous_outpoint_address": "string",
        "previous_outpoint_amount": 0,
        "signature_script": "string",
        "sig_op_count": "string",
        "compute_budget": 0,
        "covenant_id": "string"
      }
    ],
    "outputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "covenant_authorizing_input": 0,
        "covenant_id": "string"
      }
    ]
  }
]

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

Blocks

Get Blocks

GET

https://kas.nownodes.io/blocks

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. In the transactions of a block, every input now carries computeBudget and every output carries the covenant object. Both are filled in only for the transactions that use these features, otherwise they are null.

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

Parameters

lowHashstringrequiredquery

includeBlocksbooleanfalsequery

includeTransactionsbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/blocks')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://kas.nownodes.io/blocks";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/blocks')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "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,
              "computeBudget": 0
            }
          ],
          "outputs": [
            {
              "amount": 0,
              "scriptPublicKey": {
                "scriptPublicKey": "string",
                "version": 0
              },
              "verboseData": {
                "scriptPublicKeyType": "string",
                "scriptPublicKeyAddress": "string"
              },
              "covenant": {
                "authorizingInput": 0,
                "covenantId": "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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Lists blocks of a given blueScore

Parameters

blueScoreinteger43679173query

includeTransactionsbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/blocks-from-bluescore')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://kas.nownodes.io/blocks-from-bluescore";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/blocks-from-bluescore')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

[
  {
    "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,
            "computeBudget": 0
          }
        ],
        "outputs": [
          {
            "amount": 0,
            "scriptPublicKey": {
              "scriptPublicKey": "string",
              "version": 0
            },
            "verboseData": {
              "scriptPublicKeyType": "string",
              "scriptPublicKeyAddress": "string"
            },
            "covenant": {
              "authorizingInput": 0,
              "covenantId": "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 Block

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Get block information for a given block id

Parameters

blockIdstringrequiredpath

includeTransactionsbooleantruequery

includeColorbooleanfalsequery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/blocks/{blockId}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://kas.nownodes.io/blocks/{blockId}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/blocks/{blockId}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "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,
          "computeBudget": 0
        }
      ],
      "outputs": [
        {
          "amount": 0,
          "scriptPublicKey": {
            "scriptPublicKey": "string",
            "version": 0
          },
          "verboseData": {
            "scriptPublicKeyType": "string",
            "scriptPublicKeyAddress": "string"
          },
          "covenant": {
            "authorizingInput": 0,
            "covenantId": "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

Search For Transactions

POST

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

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

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.

acceptanceAcceptanceModequery

Only used when searching using transactionIds

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/transactions/search')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "transactionIds": [
      "string"
    ],
    "acceptingBlueScores": {
      "gte": 0,
      "lt": 0
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

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();

const endpoint = "https://kas.nownodes.io/transactions/search";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({
    "transactionIds": [
      "string"
    ],
    "acceptingBlueScores": {
      "gte": 0,
      "lt": 0
    }
  });
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/transactions/search')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "transactionIds": [
      "string"
    ],
    "acceptingBlueScores": {
      "gte": 0,
      "lt": 0
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

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,
    "version": 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",
          "covenant_authorizing_input": 0,
          "covenant_id": "string"
        },
        "previous_outpoint_address": "string",
        "previous_outpoint_amount": 0,
        "signature_script": "string",
        "sig_op_count": "string",
        "compute_budget": 0,
        "covenant_id": "string"
      }
    ],
    "outputs": [
      {
        "transaction_id": "string",
        "index": 0,
        "amount": 0,
        "script_public_key": "string",
        "script_public_key_address": "string",
        "script_public_key_type": "string",
        "covenant_authorizing_input": 0,
        "covenant_id": "string"
      }
    ]
  }
]

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

Get Transaction

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Get details for a given transaction id

Parameters

transactionIdstringrequiredpath

blockHashstringquery

Specify a containing block (if known) for faster lookup

inputsbooleantruequery

outputsbooleantruequery

resolve_previous_outpointsPreviousOutpointLookupModenoquery

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

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();

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/transactions/{transactionId}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://kas.nownodes.io/transactions/{transactionId}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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()

require 'net/http'
require 'json'

uri = URI('https://kas.nownodes.io/transactions/{transactionId}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "subnetwork_id": "string",
  "transaction_id": "string",
  "hash": "string",
  "mass": "string",
  "payload": "string",
  "block_hash": [
    "string"
  ],
  "block_time": 0,
  "version": 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",
        "covenant_authorizing_input": 0,
        "covenant_id": "string"
      },
      "previous_outpoint_address": "string",
      "previous_outpoint_amount": 0,
      "signature_script": "string",
      "sig_op_count": "string",
      "compute_budget": 0,
      "covenant_id": "string"
    }
  ],
  "outputs": [
    {
      "transaction_id": "string",
      "index": 0,
      "amount": 0,
      "script_public_key": "string",
      "script_public_key_address": "string",
      "script_public_key_type": "string",
      "covenant_authorizing_input": 0,
      "covenant_id": "string"
    }
  ]
}

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

Documentation

How to migrate to NOWNodes

Kaspa REST-API server 2.1.6 to 2.3.0 API CHANGES

Changed

About the new fields

Authentication

REST API changelog 2.1.6 to 2.3.0

Addresses

Get Full Transactions For Address

Authorizations

Parameters

Response

Get Full Transactions For Address Page

Authorizations

Parameters

Response

Blocks

Get Blocks

Authorizations

Parameters

Response

Get Blocks From Bluescore

Authorizations

Parameters

Response

Get Block

Authorizations

Parameters

Response

Transactions

Search For Transactions

Authorizations

Body

Parameters

Response

Get Transaction

Authorizations

Parameters

Response