Search For Transactions

POST

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

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. The version field is now documented as well - the server already returned it before it was listed.

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"
    }
  ]
}