Returns a list of Runtime blocks.

Changed on
get/{runtime}/blocks

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/{runtime}/blocks
  • Auth: none declared

Path parameters

runtime'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher' required
Example:sapphire

The runtime which to query.

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.

Response

A JSON object containing a list of Runtime 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": [
    {
      "round": 3283246,
      "hash": "21c243cd34bedfc234f1b45615d10a868f0655f59578f063a7d2fc8c6e5b4009",
      "timestamp": "2022-10-15T00:05:34Z",
      "num_transactions": 1,
      "size": 203,
      "gas_used": 118597,
      "min_gas_price": "1234567890123456789012"
    }
  ]
}

Changes

  • v1b75020aec226Revision changes
    • info

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

  • v19d302aadedb6Revision changes
    • warning

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