Query Parameters

query

string

REQUIRED

query is a string, which has a form: 'condition AND condition ...' (no OR at the moment). condition has a form: 'key operation operand'. key is a string with a restricted set of possible symbols (

()'=>< are not allowed). operation can be =, <, <=, >, >=, CONTAINS. An operand can be a string (escaped with single quotes), number, date, or time

prove

boolean

REQUIRED

Adds proofs of the transactions inclusion in the block

page

integer

REQUIRED

The page number (1-based). The default value is 1

per_page

integer

REQUIRED

The number of entries per page. The default value is 30

order_by

string

REQUIRED

The order in which transactions are sorted (asc or desc), by height & index. If empty, default asc sorting still applies

match_events

boolean

Matches attributes in query within events, in addition to the height and txhash

Returns

result

object

The result object with the following fields:

blocks

array

An array of matching blocks

block_id

object

The block ID

block

object

The block data

total_count

string

The total count of blocks

Request

1
curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc'

1
curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc'

1
curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "jsonrpc": "2.0",
5
    "method": "block_search",
6
    "params": ["YOUR_QUERY", PROVE, "1", "30", "ORDER_BY"],
7
    "id": 1
8
}'

1
curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "jsonrpc": "2.0",
5
    "method": "block_search",
6
    "params": ["YOUR_QUERY", PROVE, "1", "30", "ORDER_BY"],
7
    "id": 1
8
}'

1
const requestOptions = {
2
  method: "GET",
3
  redirect: "follow"
4
};
5

6
fetch("https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc", requestOptions)
7
  .then((response) => response.text())
8
  .then((result) => console.log(result))
9
  .catch((error) => console.error(error));

1
const requestOptions = {
2
  method: "GET",
3
  redirect: "follow"
4
};
5

6
fetch("https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc", requestOptions)
7
  .then((response) => response.text())
8
  .then((result) => console.log(result))
9
  .catch((error) => console.error(error));

1
import requests
2

3
url = "https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=True&page=1&per_page=30&order_by=asc"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
import requests
2

3
url = "https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=True&page=1&per_page=30&order_by=asc"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10

11
response = https.request(request)
12
puts response.read_body
13

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.celestia-mainnet.quiknode.pro/block_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10

11
response = https.request(request)
12
puts response.read_body
13

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free