Statistics

Get statistics

Returns a list of end-of-block statistics.

get/v1/statistics

Query parameters

eqinteger nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

neinteger nullable

Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtinteger nullable

Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

geinteger nullable

Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltinteger nullable

Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

leinteger nullable

Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

ininteger[] nullable

In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

niinteger[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filters statistics by level.

eqstring date-time nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a datetime value to get items where the specified field is equal to the specified value.

Example: ?timestamp=2020-02-20T02:40:57Z.

nestring date-time nullable

Not equal filter mode.
Specify a datetime value to get items where the specified field is not equal to the specified value.

Example: ?timestamp.ne=2020-02-20T02:40:57Z.

gtstring date-time nullable

Greater than filter mode.
Specify a datetime value to get items where the specified field is greater than the specified value.

Example: ?timestamp.gt=2020-02-20T02:40:57Z.

gestring date-time nullable

Greater or equal filter mode.
Specify a datetime value to get items where the specified field is greater than equal to the specified value.

Example: ?timestamp.ge=2020-02-20T02:40:57Z.

ltstring date-time nullable

Less than filter mode.
Specify a datetime value to get items where the specified field is less than the specified value.

Example: ?timestamp.lt=2020-02-20T02:40:57Z.

lestring date-time nullable

Less or equal filter mode.
Specify a datetime value to get items where the specified field is less than or equal to the specified value.

Example: ?timestamp.le=2020-02-20T02:40:57Z.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is equal to one of the specified values.

Example: ?timestamp.in=2020-02-20,2020-02-21.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is not equal to all the specified values.

Example: ?timestamp.ni=2020-02-20,2020-02-21.

Filters statistics by timestamp.

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 delegators by specified field. Supported fields: id (default), level, cycle, date.

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

cycleinteger nullable

Cycle at the end of which the statistics has been calculated. This field is only present in cyclic statistics.

datestring date-time nullable

Day at the end of which the statistics has been calculated. This field is only present in daily statistics.

levelinteger

Level of the block at which the statistics has been calculated

timestampstring date-time

Timestamp of the block at which the statistics has been calculated (ISO 8601, e.g. 2020-02-20T02:40:57Z)

totalSupplyinteger

Total supply - all existing tokens (including locked vested funds and frozen funds) plus not yet activated fundraiser tokens

circulatingSupplyinteger

Circulating supply - all active tokens which can affect supply and demand (can be spent/transferred)

totalBootstrappedinteger

Total amount of tokens initially created when starting the blockchain

totalCommitmentsinteger

Total commitment amount (tokens to be activated by fundraisers)

totalActivatedinteger

Total amount of tokens activated by fundraisers

totalCreatedinteger

Total amount of created/issued tokens

totalBurnedinteger

Total amount of burned tokens

totalBanishedinteger

Total amount of tokens sent to the null-address, which is equivalent to burning

totalFrozeninteger

Total amount of frozen tokens (frozen security deposits, frozen rewards and frozen fees)

totalRollupBondsinteger

Total amount of tokens locked as rollup bonds

totalSmartRollupBondsinteger

Total amount of tokens locked as smart rollup bonds

totalLostinteger

Total amount lost due to inaccuracy of the economic protocol introduced in Oxford. This amount is literally lost, because it is no longer available for the account in any mean, but for some reason it is counted as delegated.

totalOwnStakedinteger

Total active bakers' own staked balance

totalOwnDelegatedinteger

Total active bakers' own delegated balance

totalExternalStakedinteger

Total active bakers' external staked balance

totalExternalDelegatedinteger

Total active bakers' external delegated balance

totalBakingPowerinteger

Total active bakers' baking power

totalVotingPowerinteger

Total active bakers' voting power

totalBakersinteger

Total number of active bakers

totalStakersinteger

Total number of active bakers' stakers

totalDelegatorsinteger

Total number of active bakers' delegators

Changes

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