Sign in

Returns a list of consensus blocks, sorted from most to least recent.

Changed on
get/consensus/blocks

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/consensus/blocks
  • Auth: none declared

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

The number of items to skip before starting to collect the result set.

frominteger

A filter on minimum block height, inclusive.

tointeger

A filter on maximum block height, inclusive.

afterstring date-time

A filter on minimum block time, inclusive.

beforestring date-time

A filter on maximum block time, exclusive.

hashstring

A filter on the block hash.

proposed_bystring

An Oasis-style (bech32) address.

Example:oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p

A filter on the proposer of the block.

Response

A JSON object containing a list of consensus blocks.

total_countinteger required

The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.

is_total_count_clippedboolean required

Whether total_count is clipped for performance reasons.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "blocks": [
    {
      "height": 8048956,
      "hash": "0a29ac21fa69bb9e43e5cb25d10826ff3946f1ce977e82f99a2614206a50765c",
      "timestamp": "2022-03-01T00:00:00Z",
      "num_transactions": 17,
      "gas_limit": 30000,
      "epoch": 13402,
      "state_root": "8e39bf193f8a954ab8f8d7cb6388c591fd0785ea060bbd8e3752e266b54499d3",
      "proposer": {
        "entity_id": "`TqUyj5Q+9vZtqu10yw6Zw7HEX3Ywe0JQA9vHyzY47TU=`",
        "entity_address": "`oasis1qzzd6khm3acqskpxlk9vd5044cmmcce78y5l6000`",
        "entity_metadata": "An entity with all fields:\n\n    {\n      \"v\": 1,\n      \"serial\": 1,\n      \"name\": \"Entity display name\",\n      \"url\": \"https://example.org/entity\",\n      \"email\": \"entity@example.org\",\n      \"keybase\": \"keybase_handle\",\n      \"twitter\": \"twitter_handle\"\n    }\n"
      },
      "signers": [
        {
          "entity_id": "`TqUyj5Q+9vZtqu10yw6Zw7HEX3Ywe0JQA9vHyzY47TU=`",
          "entity_address": "`oasis1qzzd6khm3acqskpxlk9vd5044cmmcce78y5l6000`",
          "entity_metadata": "An entity with all fields:\n\n    {\n      \"v\": 1,\n      \"serial\": 1,\n      \"name\": \"Entity display name\",\n      \"url\": \"https://example.org/entity\",\n      \"email\": \"entity@example.org\",\n      \"keybase\": \"keybase_handle\",\n      \"twitter\": \"twitter_handle\"\n    }\n"
        }
      ],
      "gas_used": 123456
    }
  ]
}

Changes

  • v145e86f2c70b8Revision changes
    • breaking

      the /////// response's property type changed from no type to integer, and format from no format to uint64 for status

    • breaking

      the /////// response's property type changed from no type to integer, and format from no format to uint64 for status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      removed from the /////// response property allOf list for the response status

    • info

      removed from the /////// response property allOf list for the response status

  • v19d302aadedb6Revision changes
    • breaking

      the /////// response's property type changed from integer to no type, and format from uint64 to no format for status

    • breaking

      the /////// response's property type changed from integer to no type, and format from uint64 to no format for status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • info

      added to the /////// response property allOf list for the response status

    • info

      added to the /////// response property allOf list for the response status