The Statistics API from Tezos — 4 operation(s) for statistics.
4 of 4 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/tezos:tezos-statistics-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: TzKT Statistics API
description: '# Introduction
TzKT is the most widely used tool in Tezos that provides you with convenient and flexible access to the Tezos blockchain data, processed and indexed by its own indexer.'
contact:
name: Baking Bad Team
url: https://bakingbad.dev
email: hello@bakingbad.dev
version: 1.17.1
x-logo:
url: https://tzkt.io/logo.png
href: https://tzkt.io/
servers:
- url: https://api.tzkt.io
tags:
- name: Statistics
paths:
/v1/statistics:
get:
tags:
- Statistics
summary: Get statistics
description: Returns a list of end-of-block statistics.
operationId: Statistics_Get
parameters:
- name: level
in: query
description: Filters statistics by level.
schema:
oneOf:
- $ref: '#/components/schemas/Int32Parameter'
x-position: 1
x-tzkt-extension: query-parameter
- name: timestamp
in: query
description: Filters statistics by timestamp.
schema:
oneOf:
- $ref: '#/components/schemas/TimestampParameter'
x-position: 2
x-tzkt-extension: query-parameter
- name: select
in: query
description: 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.
schema:
oneOf:
- $ref: '#/components/schemas/SelectParameter'
x-position: 3
x-tzkt-extension: query-parameter
- name: sort
in: query
description: 'Sorts delegators by specified field. Supported fields: `id` (default), `level`, `cycle`, `date`.'
schema:
oneOf:
- $ref: '#/components/schemas/SortParameter'
x-position: 4
x-tzkt-extension: query-parameter
- name: offset
in: query
description: Specifies which or how many items should be skipped
schema:
oneOf:
- $ref: '#/components/schemas/OffsetParameter'
x-position: 5
x-tzkt-extension: query-parameter
- name: limit
in: query
description: Maximum number of items to return
schema:
type: integer
format: int32
default: 100
maximum: 10000.0
minimum: 0.0
x-position: 6
- name: quote
in: query
description: Comma-separated list of ticker symbols to inject historical prices into response
schema:
default: None
oneOf:
- $ref: '#/components/schemas/Symbols'
x-position: 7
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Statistics'
/v1/statistics/daily:
get:
tags:
- Statistics
summary: Get daily statistics
description: Returns a list of end-of-day statistics.
operationId: Statistics_GetDaily
parameters:
- name: date
in: query
description: Filters statistics by date.
schema:
oneOf:
- $ref: '#/components/schemas/DateTimeParameter'
x-position: 1
x-tzkt-extension: query-parameter
- name: select
in: query
description: 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.
schema:
oneOf:
- $ref: '#/components/schemas/SelectParameter'
x-position: 2
x-tzkt-extension: query-parameter
- name: sort
in: query
description: 'Sorts delegators by specified field. Supported fields: `id` (default), `level`, `cycle`, `date`.'
schema:
oneOf:
- $ref: '#/components/schemas/SortParameter'
x-position: 3
x-tzkt-extension: query-parameter
- name: offset
in: query
description: Specifies which or how many items should be skipped
schema:
oneOf:
- $ref: '#/components/schemas/OffsetParameter'
x-position: 4
x-tzkt-extension: query-parameter
- name: limit
in: query
description: Maximum number of items to return
schema:
type: integer
format: int32
default: 100
maximum: 10000.0
minimum: 0.0
x-position: 5
- name: quote
in: query
description: Comma-separated list of ticker symbols to inject historical prices into response
schema:
default: None
oneOf:
- $ref: '#/components/schemas/Symbols'
x-position: 6
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Statistics'
/v1/statistics/cyclic:
get:
tags:
- Statistics
summary: Get cyclic statistics
description: Returns a list of end-of-cycle statistics.
operationId: Statistics_GetCyclic
parameters:
- name: cycle
in: query
description: Filters statistics by cycle.
schema:
oneOf:
- $ref: '#/components/schemas/Int32Parameter'
x-position: 1
x-tzkt-extension: query-parameter
- name: select
in: query
description: 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.
schema:
oneOf:
- $ref: '#/components/schemas/SelectParameter'
x-position: 2
x-tzkt-extension: query-parameter
- name: sort
in: query
description: 'Sorts delegators by specified field. Supported fields: `id` (default), `level`, `cycle`, `date`.'
schema:
oneOf:
- $ref: '#/components/schemas/SortParameter'
x-position: 3
x-tzkt-extension: query-parameter
- name: offset
in: query
description: Specifies which or how many items should be skipped
schema:
oneOf:
- $ref: '#/components/schemas/OffsetParameter'
x-position: 4
x-tzkt-extension: query-parameter
- name: limit
in: query
description: Maximum number of items to return
schema:
type: integer
format: int32
default: 100
maximum: 10000.0
minimum: 0.0
x-position: 5
- name: quote
in: query
description: Comma-separated list of ticker symbols to inject historical prices into response
schema:
default: None
oneOf:
- $ref: '#/components/schemas/Symbols'
x-position: 6
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Statistics'
/v1/statistics/current:
get:
tags:
- Statistics
summary: Get current statistics
description: Returns statistics at the end of a head block.
operationId: Statistics_GetCurrent
parameters:
- name: select
in: query
description: Specify comma-separated list of fields to include into response or leave it undefined to return full object. If you select a single field, response will be a single value in both `.fields` and `.values` modes.
schema:
oneOf:
- $ref: '#/components/schemas/SelectParameter'
x-position: 1
x-tzkt-extension: query-parameter
- name: quote
in: query
description: Comma-separated list of ticker symbols to inject historical prices into response
schema:
default: None
oneOf:
- $ref: '#/components/schemas/Symbols'
x-position: 2
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/Statistics'
components:
schemas:
QuoteShort:
type: object
additionalProperties: false
properties:
btc:
type:
- number
- 'null'
description: XTZ/BTC price
format: double
eur:
type:
- number
- 'null'
description: XTZ/EUR price
format: double
usd:
type:
- number
- 'null'
description: XTZ/USD price
format: double
cny:
type:
- number
- 'null'
description: XTZ/CNY price
format: double
jpy:
type:
- number
- 'null'
description: XTZ/JPY price
format: double
krw:
type:
- number
- 'null'
description: XTZ/KRW price
format: double
eth:
type:
- number
- 'null'
description: XTZ/ETH price
format: double
gbp:
type:
- number
- 'null'
description: XTZ/GBP price
format: double
SelectParameter:
type: object
additionalProperties: false
properties:
fields:
type:
- array
- 'null'
description: '**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 } ]`.'
items:
type: string
values:
type:
- array
- 'null'
description: '**Values** selection mode. \
Specify a comma-separated list of fields to include their values into response.
Example: `?select.values=address,balance` => `[ [ "asd", 10 ] ]`.'
items:
type: string
x-tzkt-extension: query-parameter
TimestampParameter:
type: object
additionalProperties: false
properties:
eq:
type:
- string
- 'null'
description: '**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`.'
format: date-time
ne:
type:
- string
- 'null'
description: '**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`.'
format: date-time
gt:
type:
- string
- 'null'
description: '**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`.'
format: date-time
ge:
type:
- string
- 'null'
description: '**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`.'
format: date-time
lt:
type:
- string
- 'null'
description: '**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`.'
format: date-time
le:
type:
- string
- 'null'
description: '**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`.'
format: date-time
in:
type:
- array
- 'null'
description: '**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`.'
items:
type: string
format: date-time
ni:
type:
- array
- 'null'
description: '**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`.'
items:
type: string
format: date-time
x-tzkt-extension: query-parameter
Statistics:
type: object
additionalProperties: false
properties:
cycle:
type:
- integer
- 'null'
description: Cycle at the end of which the statistics has been calculated. This field is only present in cyclic statistics.
format: int32
date:
type:
- string
- 'null'
description: Day at the end of which the statistics has been calculated. This field is only present in daily statistics.
format: date-time
level:
type: integer
description: Level of the block at which the statistics has been calculated
format: int32
timestamp:
type: string
description: Timestamp of the block at which the statistics has been calculated (ISO 8601, e.g. `2020-02-20T02:40:57Z`)
format: date-time
totalSupply:
type: integer
description: Total supply - all existing tokens (including locked vested funds and frozen funds) plus not yet activated fundraiser tokens
format: int64
circulatingSupply:
type: integer
description: Circulating supply - all active tokens which can affect supply and demand (can be spent/transferred)
format: int64
totalBootstrapped:
type: integer
description: Total amount of tokens initially created when starting the blockchain
format: int64
totalCommitments:
type: integer
description: Total commitment amount (tokens to be activated by fundraisers)
format: int64
totalActivated:
type: integer
description: Total amount of tokens activated by fundraisers
format: int64
totalCreated:
type: integer
description: Total amount of created/issued tokens
format: int64
totalBurned:
type: integer
description: Total amount of burned tokens
format: int64
totalBanished:
type: integer
description: Total amount of tokens sent to the null-address, which is equivalent to burning
format: int64
totalFrozen:
type: integer
description: Total amount of frozen tokens (frozen security deposits, frozen rewards and frozen fees)
format: int64
totalRollupBonds:
type: integer
description: Total amount of tokens locked as rollup bonds
format: int64
totalSmartRollupBonds:
type: integer
description: Total amount of tokens locked as smart rollup bonds
format: int64
totalLost:
type: integer
description: '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.'
format: int64
totalOwnStaked:
type: integer
description: Total active bakers' own staked balance
format: int64
totalOwnDelegated:
type: integer
description: Total active bakers' own delegated balance
format: int64
totalExternalStaked:
type: integer
description: Total active bakers' external staked balance
format: int64
totalExternalDelegated:
type: integer
description: Total active bakers' external delegated balance
format: int64
totalBakingPower:
type: integer
description: Total active bakers' baking power
format: int64
totalVotingPower:
type: integer
description: Total active bakers' voting power
format: int64
totalBakers:
type: integer
description: Total number of active bakers
format: int32
totalStakers:
type: integer
description: Total number of active bakers' stakers
format: int32
totalDelegators:
type: integer
description: Total number of active bakers' delegators
format: int32
quote:
description: Injected historical quote at the time of the block at which the statistics has been calculated
oneOf:
- $ref: '#/components/schemas/QuoteShort'
DateTimeParameter:
type: object
additionalProperties: false
properties:
eq:
type:
- string
- 'null'
description: '**Equal** filter mode (optional, i.e. `param.eq=2020-01-01` is the same as `param=2020-01-01`). \
Specify a datetime to get items where the specified field is equal to the specified value.
Example: `?timestamp=2020-02-20T02:40:57Z`.'
format: date-time
ne:
type:
- string
- 'null'
description: '**Not equal** filter mode. \
Specify a datetime to get items where the specified field is not equal to the specified value.
Example: `?timestamp.ne=2020-02-20T02:40:57Z`.'
format: date-time
gt:
type:
- string
- 'null'
description: '**Greater than** filter mode. \
Specify a datetime to get items where the specified field is greater than the specified value.
Example: `?timestamp.gt=2020-02-20T02:40:57Z`.'
format: date-time
ge:
type:
- string
- 'null'
description: '**Greater or equal** filter mode. \
Specify a datetime to get items where the specified field is greater than equal to the specified value.
Example: `?timestamp.ge=2020-02-20T02:40:57Z`.'
format: date-time
lt:
type:
- string
- 'null'
description: '**Less than** filter mode. \
Specify a datetime to get items where the specified field is less than the specified value.
Example: `?timestamp.lt=2020-02-20T02:40:57Z`.'
format: date-time
le:
type:
- string
- 'null'
description: '**Less or equal** filter mode. \
Specify a datetime to get items where the specified field is less than or equal to the specified value.
Example: `?timestamp.le=2020-02-20T02:40:57Z`.'
format: date-time
in:
type:
- array
- 'null'
description: '**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`.'
items:
type: string
format: date-time
ni:
type:
- array
- 'null'
description: '**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`.'
items:
type: string
format: date-time
x-tzkt-extension: query-parameter
Symbols:
type: string
description: ''
x-enumFlags: true
x-enumNames:
- None
- Btc
- Eur
- Usd
- Cny
- Jpy
- Krw
- Eth
- Gbp
enum:
- None
- Btc
- Eur
- Usd
- Cny
- Jpy
- Krw
- Eth
- Gbp
Int32Parameter:
type: object
additionalProperties: false
properties:
eq:
type:
- integer
- 'null'
description: '**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`.'
format: int32
ne:
type:
- integer
- 'null'
description: '**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`.'
format: int32
gt:
type:
- integer
- 'null'
description: '**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`.'
format: int32
ge:
type:
- integer
- 'null'
description: '**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`.'
format: int32
lt:
type:
- integer
- 'null'
description: '**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`.'
format: int32
le:
type:
- integer
- 'null'
description: '**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`.'
format: int32
in:
type:
- array
- 'null'
description: '**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`.'
items:
type: integer
format: int32
ni:
type:
- array
- 'null'
description: '**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`.'
items:
type: integer
format: int32
x-tzkt-extension: query-parameter
SortParameter:
type: object
additionalProperties: false
properties:
asc:
type:
- string
- 'null'
description: '**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:
type:
- string
- 'null'
description: '**Descending** sort mode. \
Specify a field name to sort by descending.
Example: `?sort.desc=id`.'
x-tzkt-extension: query-parameter
OffsetParameter:
type: object
additionalProperties: false
properties:
el:
type:
- integer
- 'null'
description: '**Elements** offset mode (optional, i.e. `offset.el=123` is the same as `offset=123`). \
Skips specified number of elements.
Example: `?offset=100`.'
format: int32
pg:
type:
- integer
- 'null'
description: '**Page** offset mode. \
Skips `page * limit` elements. This is a classic pagination.
Example: `?offset.pg=1`.'
format: int32
cr:
type:
- integer
- 'null'
description: '**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`.'
format: int64
x-tzkt-extension: query-parameter
x-generator: NSwag v14.2.0.0 (NJsonSchema v11.1.0.0 (Newtonsoft.Json v13.0.0.0))
x-tagGroups:
- name: REST API
tags:
- Accounts
- BigMaps
- Blocks
- Commitments
- Constants
- Contracts
- Cycles
- Delegates
- Domains
- Events
- Head
- Helpers
- Operations
- Protocols
- Quotes
- Rewards
- Rights
- SmartRollups
- Software
- Staking
- Statistics
- Tickets
- Tokens
- Voting
- name: WebSocket API
tags:
- Get Started
- Subscriptions
- Examples
- name: Libraries
tags:
- Typescript SDK
- Taquito extension
x-provenance:
method: harvested
publisher: Tezos
source: https://api.tzkt.io/v1/swagger.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)