v1

latestOpenAPI 3.0.0Apache 2.02026-07-17304991.5 KB
Info

Search for blocks by BeginBlock and EndBlock events

Search for blocks by BeginBlock and EndBlock events.

See /subscribe for the query syntax.

get/block_search

Query parameters

querystring required
Example:block.height > 1000 AND valset.changed > 0

Query

pageinteger
Example:1

Page number (1-based)

per_pageinteger
Example:30

Number of entries per page (max: 100)

order_bystring
Example:asc

Order in which blocks are sorted ("asc" or "desc"), by height. If empty, default sorting will be still applied.

Response

List of paginated blocks matching the search criteria.

jsonrpcstring required
idinteger required

Example response

{
  "jsonrpc": "2.0",
  "result": {
    "height": "12",
    "txs_results": [
      {
        "code": "0",
        "log": "not enough gas",
        "gas_wanted": "100",
        "gas_used": "100",
        "events": [
          {
            "type": "app",
            "attributes": [
              {
                "key": "YWN0aW9u",
                "value": "c2VuZA=="
              }
            ]
          }
        ],
        "codespace": "ibc"
      }
    ],
    "begin_block_events": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA=="
          }
        ]
      }
    ],
    "end_block": [
      {
        "type": "app",
        "attributes": [
          {
            "key": "YWN0aW9u",
            "value": "c2VuZA=="
          }
        ]
      }
    ],
    "validator_updates": [
      {
        "pub_key": {
          "type": "tendermint/PubKeyEd25519",
          "value": "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM="
        },
        "power": "300"
      }
    ],
    "consensus_params_updates": {
      "block": {
        "max_bytes": "22020096",
        "max_gas": "1000",
        "time_iota_ms": "1000"
      },
      "evidence": {
        "max_age_num_blocks": "100000",
        "max_age_duration": "172800000000000"
      },
      "validator": {
        "pub_key_types": [
          "ed25519"
        ]
      }
    }
  }
}