---
title: "Get cyclic statistics"
method: GET
path: "/v1/statistics/cyclic"
tags: ["Statistics"]
---

# Get cyclic statistics

`GET /v1/statistics/cyclic`

Returns a list of end-of-cycle statistics.

## Query parameters

- `cycle` Int32Parameter
  - `eq` integer, 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`.
  - `ne` integer, 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`.
  - `gt` integer, 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`.
  - `ge` integer, 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`.
  - `lt` integer, 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`.
  - `le` integer, 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`.
  - `in` integer[], 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`.
  - `ni` integer[], 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`.
- `select` SelectParameter
  - `fields` string[], 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 } ]`.
  - `values` string[], nullable — **Values** selection mode. \ Specify a comma-separated list of fields to include their values into response. Example: `?select.values=address,balance` => `[ [ "asd", 10 ] ]`.
- `sort` SortParameter
  - `asc` string, 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`.
  - `desc` string, nullable — **Descending** sort mode. \ Specify a field name to sort by descending. Example: `?sort.desc=id`.
- `offset` OffsetParameter
  - `el` integer, nullable — **Elements** offset mode (optional, i.e. `offset.el=123` is the same as `offset=123`). \ Skips specified number of elements. Example: `?offset=100`.
  - `pg` integer, nullable — **Page** offset mode. \ Skips `page * limit` elements. This is a classic pagination. Example: `?offset.pg=1`.
  - `cr` integer, 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`.
- `limit` integer
- `quote` 'None' | 'Btc' | 'Eur' | 'Usd' | 'Cny' | 'Jpy' | 'Krw' | 'Eth' | 'Gbp'

## Response `200`

- Statistics[]
  - `cycle` integer, nullable — Cycle at the end of which the statistics has been calculated. This field is only present in cyclic statistics.
  - `date` string, date-time, nullable — Day at the end of which the statistics has been calculated. This field is only present in daily statistics.
  - `level` integer — Level of the block at which the statistics has been calculated
  - `timestamp` string, date-time — Timestamp of the block at which the statistics has been calculated (ISO 8601, e.g. `2020-02-20T02:40:57Z`)
  - `totalSupply` integer — Total supply - all existing tokens (including locked vested funds and frozen funds) plus not yet activated fundraiser tokens
  - `circulatingSupply` integer — Circulating supply - all active tokens which can affect supply and demand (can be spent/transferred)
  - `totalBootstrapped` integer — Total amount of tokens initially created when starting the blockchain
  - `totalCommitments` integer — Total commitment amount (tokens to be activated by fundraisers)
  - `totalActivated` integer — Total amount of tokens activated by fundraisers
  - `totalCreated` integer — Total amount of created/issued tokens
  - `totalBurned` integer — Total amount of burned tokens
  - `totalBanished` integer — Total amount of tokens sent to the null-address, which is equivalent to burning
  - `totalFrozen` integer — Total amount of frozen tokens (frozen security deposits, frozen rewards and frozen fees)
  - `totalRollupBonds` integer — Total amount of tokens locked as rollup bonds
  - `totalSmartRollupBonds` integer — Total amount of tokens locked as smart rollup bonds
  - `totalLost` integer — 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.
  - `totalOwnStaked` integer — Total active bakers' own staked balance
  - `totalOwnDelegated` integer — Total active bakers' own delegated balance
  - `totalExternalStaked` integer — Total active bakers' external staked balance
  - `totalExternalDelegated` integer — Total active bakers' external delegated balance
  - `totalBakingPower` integer — Total active bakers' baking power
  - `totalVotingPower` integer — Total active bakers' voting power
  - `totalBakers` integer — Total number of active bakers
  - `totalStakers` integer — Total number of active bakers' stakers
  - `totalDelegators` integer — Total number of active bakers' delegators
  - `quote` QuoteShort
    - `btc` number, double, nullable — XTZ/BTC price
    - `eur` number, double, nullable — XTZ/EUR price
    - `usd` number, double, nullable — XTZ/USD price
    - `cny` number, double, nullable — XTZ/CNY price
    - `jpy` number, double, nullable — XTZ/JPY price
    - `krw` number, double, nullable — XTZ/KRW price
    - `eth` number, double, nullable — XTZ/ETH price
    - `gbp` number, double, nullable — XTZ/GBP price

---

[API](https://skmtc.dev/tzkt/apis/tzkt-api.md) · [All operations](https://skmtc.dev/tzkt/apis/tzkt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tzkt/tzkt-api/revisions/a2e2aba5e534/schema)
