/query/json.
Body
integer
default:"0"
First block, inclusive.
integer
default:"head"
Last block, inclusive. Above the head it’s lowered to the head.
object[]
Log filters, combined with OR. Each object may set
address, topic0–topic3 (arrays of hex)
and addressSet, topic0Set–topic3Set (set ids); set fields are combined with AND.
{} matches every log. See Filters.object[]
Transaction filters, combined with OR. Each object may set
from, to, sighash (arrays of
hex), fromSet, toSet (set ids), type (array of transaction types, 0–255) and status
(0 or 1, the same on every object).object
required
Columns to return:
{"log": {…}, "transaction": {…}, "block": {…}}, each {"<name>": true}.
See the field reference: logs,
transactions, blocks.boolean
default:"false"
Also return the transaction of every matched log. Needs a
logs filter and transaction fields.integer
default:"100000"
Target number of rows per response; the response ends at the end of the block where it’s
reached. Maximum 100,000.
integer
Keep every n-th block in the blocks stream (needs block fields).
integer
default:"0"
Phase for
blockInterval, smaller than it.boolean
default:"false"
400 invalid_query when a selected field doesn’t exist on this chain, instead of an all-null
column. See Fields a chain doesn’t have.string
A prepared query id, instead of
logs, transactions, fields,
joinTransactions and blockInterval. Only fromBlock, toBlock, maxObjects and
strictFields may accompany it.Example
Response
200, Content-Type: application/vnd.apache.arrow.stream.
The body is one complete Arrow IPC stream per row type in the response, always in the order
transactions, logs, blocks, each with its own schema and end-of-stream marker. Read them one
after another from the same body. See Reading Arrow.
Each stream’s schema metadata:
string
transactions, logs or blocks.string
All streams of the response, in order, comma-separated:
"transactions,logs".string (integer)
First block covered.
string (integer)
Last block covered.
string (integer)
fromBlock for the next page.string (integer)
Total rows in the response, across all streams. Check it against what you read.
string (integer)
The chain head at query time.
string (integer)
The newest final block at query time. Absent before the first finalization.
string (hex)
Hash of
to_block; only present when to_block is above bl.finalized_block.string (hex)
The prepared query id of this request’s filter.
Selected fields this chain doesn’t have, as
<row type>.<column>, comma-separated; "" when
none.