Block search

POST

wss://osmo.nownodes.io/wss/{api_key}

Calls the block_search method over a WebSocket connection.

Connection URL:

Copied!

wss://osmo.nownodes.io/wss/{{api_key}}

Open the connection, then send the message below as a text frame.

Example:

Copied!

wscat -c 'wss://osmo.nownodes.io/wss/YOUR_API_KEY'
> {"jsonrpc":"2.0","method":"block_search","id":0,"params":{"query":"block.height > 1000","page":"1","per_page":"30","order_by":"asc","match_events":true}}

Body

application/json

object

Parameters

api_keystringrequiredpath

Your NOWNodes API key.

Response

200OK

A successful response.

Block search

curl -X POST 'wss://osmo.nownodes.io/wss/{api_key}' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "block_search",
    "id": 0,
    "params": {
      "query": "block.height > 1000",
      "page": "1",
      "per_page": "30",
      "order_by": "asc",
      "match_events": true
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("wss://osmo.nownodes.io/wss/{api_key}");
const result = await provider.send("block_search", {
  "query": "block.height > 1000",
  "page": "1",
  "per_page": "30",
  "order_by": "asc",
  "match_events": true
});
console.log(result);

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

uri = URI('wss://osmo.nownodes.io/wss/{api_key}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "block_search",
  "params": {
    "query": "block.height > 1000",
    "page": "1",
    "per_page": "30",
    "order_by": "asc",
    "match_events": true
  },
  "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("wss://osmo.nownodes.io/wss/{api_key}"))
response = w3.provider.make_request("block_search", {
  "query": "block.height > 1000",
  "page": "1",
  "per_page": "30",
  "order_by": "asc",
  "match_events": True
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("wss://osmo.nownodes.io/wss/{api_key}"),
});

const result = await client.request({
  method: "block_search",
  params: {
  "query": "block.height > 1000",
  "page": "1",
  "per_page": "30",
  "order_by": "asc",
  "match_events": true
},
});

console.log(result);

const endpoint = "wss://osmo.nownodes.io/wss/{api_key}";
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: "block_search", params: {
  "query": "block.height > 1000",
  "page": "1",
  "per_page": "30",
  "order_by": "asc",
  "match_events": true
}, id: 1 });
console.log(result);

const response = await fetch('wss://osmo.nownodes.io/wss/{api_key}', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "block_search",
      "id": 0,
      "params": {
        "query": "block.height > 1000",
        "page": "1",
        "per_page": "30",
        "order_by": "asc",
        "match_events": true
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "block_search",
  "id": 0,
  "params": {
    "query": "block.height > 1000",
    "page": "1",
    "per_page": "30",
    "order_by": "asc",
    "match_events": True
  }
}

response = requests.post('wss://osmo.nownodes.io/wss/{api_key}', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('wss://osmo.nownodes.io/wss/{api_key}')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "block_search",
    "id": 0,
    "params": {
      "query": "block.height > 1000",
      "page": "1",
      "per_page": "30",
      "order_by": "asc",
      "match_events": true
    }
  }'

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",
  "method": "block_search",
  "id": 0,
  "params": {
    "query": "block.height > 1000",
    "page": "1",
    "per_page": "30",
    "order_by": "asc",
    "match_events": true
  }
}

200

"{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 0,\n    \"result\": {\n        \"blocks\": [\n            {\n                \"block_id\": {\n                    \"hash\": \"22F5615B1680ADF45FB63EF239B0C64671E8CAA3AD6F78C9A505946FFAD6CFC9\",\n                    \"parts\": {\n                        \"total\": 1,\n                        \"hash\": \"8DCC972C86DA465AC10AC7A51B869726D268D8F5C9869C49D2E25C7D85E37ECA\"\n                    }\n                },\n                \"block\": {\n                    \"header\": {\n                        \"version\": {\n                            \"block\": \"11\"\n                        },\n                        \"chain_id\": \"cosmoshub-4\",\n                        \"height\": \"17579576\",\n                        \"time\": \"2023-10-26T03:09:59.077127723Z\",\n                        \"last_block_id\": {\n                            \"hash\": \"ABBE1723DB5297E21A3354E109C7806574155B341EE355320F329A13C15673B9\",\n                            \"parts\": {\n                                \"total\": 2,\n                                \"hash\": \"425CDB2BDD0752E41AF19BD7BC6A31FC27E51CC3F5BCF184D38CA1F59B86A7D3\"\n                            }\n                        },\n                        \"last_commit_hash\": \"6B7EB481495AA64589DAEB59FC23FE90172AC6DB88EED08FBDCA47C5531EEA18\",\n                        \"data_hash\": \"E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855\",\n                        \"validators_hash\": \"6CFBD6AF9E0E40E28600965178ED7264B63CA9779CE109EA0DECA47CA66D1492\",\n                        \"next_validators_hash\": \"6CFBD6AF9E0E40E28600965178ED7264B63CA9779CE109EA0DECA47CA66D1492\",\n                        \"consensus_hash\": \"1E443E406B4190D5D3146B634FF09BE5E82A7E14E0D8B80211A3B46EDCBD0403\",\n                        \"app_hash\": \"FA46CC215B853A8045EC0C119A3D38F5DC71CC4A26709566006EC1659FB1CEDF\",\n                        \"last_results_hash\": \"13D92535323D92452E2E003BABF931B63D2035F078C4D4424B54615A46AAF240\",\n                        \"evidence_hash\": \"E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855\",\n                        \"proposer_address\": \"679B89785973BE94D4FDF8B66F84A929932E91C5\"\n                    },\n                    \"data\": {\n                        \"txs\": []\n                    },\n                    \"evidence\": {\n                        \"evidence\": []\n                    },\n                    \"last_commit\": {\n                        \"height\": \"17579575\",\n                        \"round\": 0,\n                        \"block_id\": {\n                            \"hash\": \"ABBE1723DB5297E21A3354E109C7806574155B341EE355320F329A13C15673B9\",\n                            \"parts\": {\n                                \"total\": 2,\n                                \"hash\": \"425CDB2BDD0752E41AF19BD7BC6A31FC27E51CC3F5BCF184D38CA1F59B86A7D3\"\n                            }\n                        },\n                        \"signatures\": [\n                            {\n                                \"block_id_flag\": 2,\n                                \"validator_address\": \"D68EEC0D2E8248F1EC64CDB585EDB61ECA432BD8\",\n                                \"timestamp\": \"2023-10-26T03:09:59.066449097Z\",\n                                \"signature\": \"0mR4KSTE4LiRMGZDoniLFLsHVAFE4ym8wZDxmxQqh6jh6XPxRaTUvIYLAPLEW8Grxa7OdNmdK8BHqeP9BXKnCg==\"\n                            },\n                            {\n                                \"block_id_flag\": 2,\n                                \"validator_address\": \"D2D458F9209ECB8CA2AAB1D99E06611B812A8797\",\n                                \"timestamp\": \"2023-10-26T03:09:59.07848835Z\",\n                                \"signature\": \"ahbAwAOw49sXtM2oJgrQABcNsqJFZOJXZ7fZrAh+kRybUwDqcpKTnBtjY/9pK1FMpajsz/kM6rc5C7N4AmuJCg==\"\n                            },\n                            {\n                                \"block_id_flag\": 2,\n                                \"validator_address\": \"1CED30733D1625C89AB698677606D0E37B3676A9\",\n                                \"timestamp\": \"2023-10-26T03:09:59.011995901Z\",\n                                \"signature\": \"1k+XITcBMkBYLerU2gbEHNrf80qkPyOZZw3aJgj7e+zHJYULfBQfFm5o4kIy4j9fp2FlBvmgZIcxduDhRNBqDQ==\"\n                            },\n...\n"