Info

Search for blocks by BeginBlock and EndBlock events

Changed on

Search for blocks by BeginBlock and EndBlock events.

See /subscribe for the query syntax.

get/block_search

Request

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"
        ]
      }
    }
  }
}

Changes

    • breaking

      the response's body type changed from no type to object for status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      endpoint added