Addresses

Get Balance From Kaspa Address

get

Get balance for a given kaspa address

Authorizations
Path parameters
kaspaAddressstringRequired

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Pattern: ^kaspa:[a-z0-9]{61,63}$
Responses
200
Successful Response
application/json
get
GET /addresses/{kaspaAddress}/balance HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

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

Get Utxos For Address

get

Lists all open utxo for a given kaspa address

Authorizations
Path parameters
kaspaAddressstringRequired

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Pattern: ^kaspa:[a-z0-9]{61,63}$
Responses
200
Successful Response
application/json
get
GET /addresses/{kaspaAddress}/utxos HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

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

Get Utxos For Addresses

post

Lists all open utxo for a given kaspa address

Authorizations
Body
addressesstring[]OptionalDefault: ["kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"]
Responses
200
Successful Response
application/json
post
POST /addresses/utxos HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

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

Get Full Transactions For Address

get

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

Authorizations
Path parameters
kaspaAddressstringRequired

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Pattern: ^kaspa:[a-z0-9]{61,63}$
Query parameters
limitinteger · min: 1 · max: 500Optional

The number of records to get

Default: 50
offsetintegerOptional

The offset from which to get records

Default: 0
fieldsstringOptionalDefault: ""
resolve_previous_outpointsall ofOptional

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.

Default: no
string · enumOptional

An enumeration.

Possible values:
Responses
200
Successful Response
application/json
get
GET /addresses/{kaspaAddress}/full-transactions HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

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

Get Addresses Active

post

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.

Authorizations
Body
addressesstring[]OptionalDefault: ["kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"]
Responses
200
Successful Response
application/json
post
POST /addresses/active HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

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

Get Full Transactions For Address Page

get

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

Authorizations
Path parameters
kaspaAddressstringRequired

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Pattern: ^kaspa:[a-z0-9]{61,63}$
Query parameters
limitinteger · min: 1 · max: 500Optional

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.

Default: 50
beforeintegerOptional

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

Default: 0
afterintegerOptional

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

Default: 0
fieldsstringOptionalDefault: ""
resolve_previous_outpointsall ofOptional

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.

Default: no
string · enumOptional

An enumeration.

Possible values:
acceptancestring · enumOptional

An enumeration.

Possible values:
Responses
200
Successful Response
application/json
get
GET /addresses/{kaspaAddress}/full-transactions-page HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

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

Get Transaction Count For Address

get

Count the number of transactions associated with this address

Authorizations
Path parameters
kaspaAddressstringRequired

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Pattern: ^kaspa:[a-z0-9]{61,63}$
Responses
200
Successful Response
application/json
get
GET /addresses/{kaspaAddress}/transactions-count HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

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

Get Addresses Names

get

Get the name for an address

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

Successful Response

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

Get Name For Address

get

Get the name for an address

Authorizations
Path parameters
kaspaAddressstringRequired

Kaspa address as string e.g. kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73

Pattern: ^kaspa:[a-z0-9]{61,63}$
Responses
200
Successful Response
application/json
get
GET /addresses/{kaspaAddress}/name HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "address": "text",
  "name": "text"
}

Get Balances From Addresses

post

Get balances for multiple Addresses

Authorizations
Body
addressesstring[]OptionalDefault: ["kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73"]
Responses
200
Successful Response
application/json
post
POST /addresses/balances HTTP/1.1
Host: kas.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "addresses": [
    "text"
  ]
}
[
  {
    "address": "kaspa:qqkqkzjvr7zwxxmjxjkmxxdwju9kjs6e9u82uh59z07vgaks6gg62v8707g73",
    "balance": 12451591699
  }
]
PreviousKAS (Kaspa)NextInfo