Search transactions

POST

https://lunc-tendermint.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Search for transactions with query filters, pagination, and sorting options

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringtx_searchrequired

The JSON-RPC method name for transaction search

paramsobjectrequired

Show child attributes

querystringrequired

Query string using Tendermint query syntax. Examples:

"tx.height=123456" - Transactions at specific height
"transfer.recipient='cosmos1...'" - Transfer transactions to recipient
"message.sender='cosmos1...'" - Transactions from specific sender
"tx.hash='ABC123...'" - Specific transaction hash

proveboolean

Whether to include merkle proofs for transactions

pageinteger

Page number for pagination (1-based)

per_pageinteger

Number of transactions per page

order_bystringascdesc

Sort order for results

Response

200OK

Transactions found successfully

Search transactions

curl -X POST 'https://lunc-tendermint.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tx_search",
    "params": {
      "query": "tx.height>=1000000 AND tx.height<=1000100",
      "prove": false,
      "page": 1,
      "per_page": 10,
      "order_by": "desc"
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://lunc-tendermint.nownodes.io/");
const result = await provider.send("tx_search", {
  "query": "tx.height>=1000000 AND tx.height<=1000100",
  "prove": false,
  "page": 1,
  "per_page": 10,
  "order_by": "desc"
});
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://lunc-tendermint.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "tx_search",
  "params": {
    "query": "tx.height>=1000000 AND tx.height<=1000100",
    "prove": false,
    "page": 1,
    "per_page": 10,
    "order_by": "desc"
  },
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://lunc-tendermint.nownodes.io/"))
response = w3.provider.make_request("tx_search", {
  "query": "tx.height>=1000000 AND tx.height<=1000100",
  "prove": False,
  "page": 1,
  "per_page": 10,
  "order_by": "desc"
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://lunc-tendermint.nownodes.io/"),
});

const result = await client.request({
  method: "tx_search",
  params: {
  "query": "tx.height>=1000000 AND tx.height<=1000100",
  "prove": false,
  "page": 1,
  "per_page": 10,
  "order_by": "desc"
},
});

console.log(result);

const endpoint = "https://lunc-tendermint.nownodes.io/";
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({ jsonrpc: "2.0", method: "tx_search", params: {
  "query": "tx.height>=1000000 AND tx.height<=1000100",
  "prove": false,
  "page": 1,
  "per_page": 10,
  "order_by": "desc"
}, id: 1 });
console.log(result);

const response = await fetch('https://lunc-tendermint.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tx_search",
      "params": {
        "query": "tx.height>=1000000 AND tx.height<=1000100",
        "prove": false,
        "page": 1,
        "per_page": 10,
        "order_by": "desc"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tx_search",
  "params": {
    "query": "tx.height>=1000000 AND tx.height<=1000100",
    "prove": False,
    "page": 1,
    "per_page": 10,
    "order_by": "desc"
  }
}

response = requests.post('https://lunc-tendermint.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://lunc-tendermint.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tx_search",
    "params": {
      "query": "tx.height>=1000000 AND tx.height<=1000100",
      "prove": false,
      "page": 1,
      "per_page": 10,
      "order_by": "desc"
    }
  }'

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tx_search",
  "params": {
    "query": "tx.height>=1000000 AND tx.height<=1000100",
    "prove": false,
    "page": 1,
    "per_page": 10,
    "order_by": "desc"
  }
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "txs": [
      {
        "hash": "A1B2C3D4E5F678901234567890ABCDEF1234567890ABCDEF1234567890ABCDEF",
        "height": "1000001",
        "index": 0,
        "tx_result": {
          "code": 0,
          "data": "CgUKA2F0b20SAjEw",
          "log": "[{\"msg_index\":0,\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"send\"}]}]}]",
          "info": "",
          "gas_wanted": "200000",
          "gas_used": "123456",
          "events": [
            {
              "type": "transfer",
              "attributes": [
                {
                  "key": "recipient",
                  "value": "cosmos1abc123..."
                }
              ]
            }
          ],
          "codespace": ""
        },
        "tx": "wrhBdNfXlQYSNQ0KASoWcCo...",
        "proof": {
          "root_hash": "XYZ789...",
          "data": "string",
          "proof": {
            "total": 1,
            "index": 0,
            "leaf_hash": "DEF456...",
            "aunts": [
              "string"
            ]
          }
        }
      }
    ],
    "total_count": 150
  }
}

Documentation

How to migrate to NOWNodes

Search transactions

Authorizations

Body

Response