Cycles

Get cycles

Returns a list of cycles, including future cycles.

get/v1/cycles

Query parameters

fieldsstring[] nullable

Fields selection mode (optional, i.e. select.fields=balance is the same as select=balance).
Specify a comma-separated list of fields to include into response.

Example: ?select=address,balance => [ { "address": "asd", "balance": 10 } ].

valuesstring[] nullable

Values selection mode.
Specify a comma-separated list of fields to include their values into response.

Example: ?select.values=address,balance => [ [ "asd", 10 ] ].

Specify comma-separated list of fields to include into response or leave it undefined to return full object. If you select single field, response will be an array of values in both .fields and .values modes.

ascstring nullable

Ascending sort mode (optional, i.e. sort.asc=id is the same as sort=id).
Specify a field name to sort by.

Example: ?sort=balance.

descstring nullable

Descending sort mode.
Specify a field name to sort by descending.

Example: ?sort.desc=id.

Sorts cycles by specified field. Supported fields: index (default, desc).

elinteger nullable

Elements offset mode (optional, i.e. offset.el=123 is the same as offset=123).
Skips specified number of elements.

Example: ?offset=100.

pginteger nullable

Page offset mode.
Skips page * limit elements. This is a classic pagination.

Example: ?offset.pg=1.

crinteger nullable

Cursor offset mode.
Skips all elements with the cursor before (including) the specified value. Cursor is a field used for sorting, e.g. id. Avoid using this offset mode with non-unique or non-sequential cursors such as amount, balance, etc.

Example: ?offset.cr=45837.

Specifies which or how many items should be skipped

limitinteger

Maximum number of items to return

quote'None' | 'Btc' | 'Eur' | 'Usd' | 'Cny' | 'Jpy' | 'Krw' | 'Eth' | 'Gbp'

Comma-separated list of ticker symbols to inject historical prices into response

Response

indexinteger

Cycle index starting from zero

firstLevelinteger

Level of the first block in the cycle

startTimestring date-time

Timestamp of the first block in the cycle

lastLevelinteger

Level of the last block in the cycle

endTimestring date-time

Timestamp of the last block in the cycle

snapshotLevelinteger

Height of the block where the snapshot was taken

randomSeedstring required

Randomly generated seed used by the network for things like baking rights distribution etc.

totalBakersinteger

Total number of all active in this cycle bakers

totalBakingPowerinteger

Total baking power of all active in this cycle bakers

blockRewardinteger

Fixed reward paid to the block payload proposer in this cycle (micro tez)

blockBonusPerBlockinteger

Bonus reward paid to the block producer in this cycle (micro tez)

attestationRewardPerBlockinteger

Reward for attestation in this cycle (micro tez)

nonceRevelationRewardinteger

Reward for seed nonce revelation in this cycle (micro tez)

vdfRevelationRewardinteger

Reward for vdf revelation in this cycle (micro tez)

dalAttestationRewardPerShardinteger

Reward for dal attestation in this cycle (micro tez)

blockBonusPerSlotinteger

DEPRECATED

attestationRewardPerSlotinteger

DEPRECATED

endorsementRewardPerSlotinteger

DEPRECATED

Changes

No recorded changes to this endpoint across all 1 revision of this API.