Tezos

aid: tezos
name: Tezos
description: 'Tezos is a self-amending blockchain platform that uses on-chain governance

  to upgrade its protocol without hard forks. The primary developer API surface

  is provided by TzKT, an open-source Tezos blockchain indexer built and

  maintained by the Baking Bad team. TzKT exposes a comprehensive REST API

  (https://api.tzkt.io) covering 100+ endpoints for querying blocks, accounts,

  operations, delegations, smart contracts, big maps, tokens (FA1.2/FA2/NFTs),

  staking data, baking rights, governance periods, and protocol metadata on

  the Tezos mainnet. The API supports deep filtering, deep selection, deep

  sorting, CSV exports, and historical data queries at specific block heights.

  A WebSocket API (SignalR) provides real-time subscription streams for new

  blocks and operations. The public TzKT API is freely available with no API

  key required; rate limits apply per IP via standard RateLimit headers and

  HTTP 429 responses. TzKT Pro is available for teams requiring elevated

  quotas and dedicated support. The indexer is MIT-licensed and can also be

  self-hosted against a Tezos node.

  '
type: Index
position: Provider
access: Public
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Tezos
- Blockchain
- TzKT
- Baking Bad
- Cryptocurrency
- Smart Contracts
- NFT
- Tokens
- Delegations
- Staking
- Governance
- FA1.2
- FA2
- WebSocket
url: https://raw.githubusercontent.com/api-evangelist/tezos/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
apis:
- aid: tezos:tzkt-accounts
  name: TzKT Accounts API
  description: 'The Accounts API returns profile data for any Tezos address — user

    wallets, delegates (bakers), smart contracts, and ghost accounts.

    Endpoints expose balance, staked amounts, token holdings, contract

    count, first and last activity timestamps, and full paginated operation

    history. A dedicated balance endpoint returns the current XTZ balance as

    a plain integer.

    '
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Accounts
  - Balances
  - Wallets
  - Delegates
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Accounts
- aid: tezos:tzkt-blocks
  name: TzKT Blocks API
  description: 'The Blocks API exposes Tezos block-level data including block hash,

    level, protocol, timestamp, baker, priority, number of operations,

    volume, fees, and reward metadata. Blocks can be fetched by hash,

    level, or queried in bulk with pagination and sorting. A lightweight

    head endpoint returns the current chain tip with live XTZ exchange

    rates.

    '
  humanURL: https://api.tzkt.io/#tag/Blocks
  baseURL: https://api.tzkt.io/v1
  tags:
  - Blocks
  - Chain
  - Head
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Blocks
- aid: tezos:tzkt-operations
  name: TzKT Operations API
  description: 'The Operations API is the broadest endpoint group in TzKT, covering

    all Tezos operation types: transactions, originations, delegations,

    reveals, endorsements, double-bake evidence, ballot and proposal

    operations, register global constants, set deposits limits, and

    more. Operations can be filtered by sender, target, level, timestamp,

    status, entrypoint, parameter, and many other fields. Supports

    pagination, sorting, and CSV export.

    '
  humanURL: https://api.tzkt.io/#tag/Operations
  baseURL: https://api.tzkt.io/v1
  tags:
  - Operations
  - Transactions
  - Originations
  - Delegations
  - Endorsements
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Operations
- aid: tezos:tzkt-contracts
  name: TzKT Contracts API
  description: 'The Contracts API provides access to Tezos smart contract metadata,

    storage, entrypoints, views, and code. Storage can be retrieved as

    decoded JSON at the current state or at a historical block level.

    Big map keys and values within contract storage are accessible through

    dedicated endpoints. Contract events (emitted via EMIT instruction)

    are also indexed.

    '
  humanURL: https://api.tzkt.io/#tag/Contracts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Contracts
  - Smart Contracts
  - Storage
  - Entrypoints
  - Events
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Contracts
- aid: tezos:tzkt-bigmaps
  name: TzKT Big Maps API
  description: 'The Big Maps API indexes all Tezos big map allocations across smart

    contracts, exposing individual key-value entries with historical

    tracking. Keys and values are decoded from Micheline to JSON. Supports

    bulk queries, filtering by contract, key hash, and active/removed

    status.

    '
  humanURL: https://api.tzkt.io/#tag/BigMaps
  baseURL: https://api.tzkt.io/v1
  tags:
  - Big Maps
  - Smart Contracts
  - Storage
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/BigMaps
- aid: tezos:tzkt-tokens
  name: TzKT Tokens API
  description: 'The Tokens API covers FA1.2, FA2, and NFT token standards on Tezos.

    Endpoints expose token metadata, holder balances, and transfer history.

    Token balances can be queried per account or per token contract;

    transfers can be filtered by sender, receiver, token ID, and time

    range. Supports pagination and CSV export.

    '
  humanURL: https://api.tzkt.io/#tag/Tokens
  baseURL: https://api.tzkt.io/v1
  tags:
  - Tokens
  - FA1.2
  - FA2
  - NFT
  - Balances
  - Transfers
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Tokens
- aid: tezos:tzkt-delegations-staking
  name: TzKT Delegations and Staking API
  description: 'The Delegations and Staking APIs expose baking (validation) economics

    on Tezos. Delegations endpoints return active and historical delegation

    assignments between addresses and bakers. Staking endpoints return

    staked balances, staking operations, and per-cycle reward splits.

    Baking rights (endorsing and baking slots) are also queryable per

    baker and per cycle.

    '
  humanURL: https://api.tzkt.io/#tag/Delegators
  baseURL: https://api.tzkt.io/v1
  tags:
  - Delegations
  - Staking
  - Baking
  - Rewards
  - Validators
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Delegators
- aid: tezos:tzkt-governance
  name: TzKT Governance API
  description: 'The Governance API exposes Tezos on-chain governance data including

    voting periods, proposals, ballots, and quorum thresholds. Developers

    can query the history of all protocol upgrade votes, the current voting

    epoch, and per-address ballot submissions.

    '
  humanURL: https://api.tzkt.io/#tag/Voting
  baseURL: https://api.tzkt.io/v1
  tags:
  - Governance
  - Voting
  - Proposals
  - Protocol
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Voting
- aid: tezos:tzkt-protocols
  name: TzKT Protocols API
  description: 'The Protocols API returns metadata for each Tezos protocol version

    including hash, first and last cycle, constants (block time, gas

    limits, baking rewards), and amendment history. Useful for building

    analytics that span multiple protocol eras.

    '
  humanURL: https://api.tzkt.io/#tag/Protocols
  baseURL: https://api.tzkt.io/v1
  tags:
  - Protocols
  - Chain Constants
  - History
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/Protocols
- aid: tezos:tzkt-websocket
  name: TzKT WebSocket API
  description: 'The TzKT WebSocket API uses SignalR to deliver real-time push

    notifications to subscribed clients. Channels cover new blocks,

    new and confirmed operations (filtered by sender, target, or

    entrypoint), big map updates, token transfers, and account balance

    changes. Reconnects and message back-fills are handled automatically

    by the SignalR client libraries available for JavaScript, .NET,

    Java, and Python.

    '
  humanURL: https://api.tzkt.io/#tag/WebSocket
  baseURL: wss://api.tzkt.io/v1/events
  tags:
  - WebSocket
  - Real-Time
  - Subscriptions
  - Events
  - SignalR
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/WebSocket
features:
- name: No Authentication Required
  description: The public TzKT API is open access — no API key or registration needed for the free tier.
- name: Deep Filtering and Sorting
  description: Every collection endpoint supports multi-field filtering, field selection, and sorting via query parameters.
- name: Historical Queries
  description: Account balances, storage values, and big map keys can be queried at any historical block level.
- name: Real-Time WebSocket Streams
  description: SignalR WebSocket channels deliver new blocks, operations, balance changes, and token transfers in real time.
- name: Token and NFT Indexing
  description: FA1.2, FA2, and NFT token contracts are fully indexed with balances, transfers, and IPFS/HTTP metadata.
- name: CSV Export
  description: Most collection endpoints support CSV download for offline analytics and reconciliation.
- name: Self-Hosting
  description: TzKT is MIT-licensed and can be run against a local or remote Tezos node via Docker.
- name: Multiple Networks
  description: Separate API instances available for mainnet, Ghostnet (testnet), and other Tezos test networks.
useCases:
- name: Block Explorer Backend
  description: Power blockchain explorers with block, operation, and account data from indexed TzKT endpoints.
- name: Wallet Integration
  description: Retrieve account balances, token holdings, and operation history for Tezos wallet applications.
- name: DeFi Analytics
  description: Track token transfers, big map state, and smart contract interactions for DeFi protocol dashboards.
- name: NFT Marketplace
  description: Index FA2 NFT mints, transfers, and metadata for marketplace discovery and ownership tracking.
- name: Baking Monitoring
  description: Monitor baker performance, staking rewards, delegation changes, and baking rights assignments.
- name: Governance Tracking
  description: Follow on-chain proposal submissions, ballot counts, and protocol amendment outcomes.
- name: Financial Reconciliation
  description: Export CSV operation history for accounting, tax reporting, and portfolio reconciliation.
authentication:
- type: None
  description: The public TzKT API at api.tzkt.io requires no authentication. Requests are rate-limited by IP address.
common:
- type: Website
  url: https://tzkt.io
- type: DeveloperPortal
  url: https://api.tzkt.io
- type: Documentation
  url: https://api.tzkt.io/
- type: GitHubOrganization
  url: https://github.com/baking-bad
- type: GitHubRepository
  url: https://github.com/baking-bad/tzkt
- type: MainnetAPI
  url: https://api.tzkt.io/v1
- type: GhostnetAPI
  url: https://api.ghostnet.tzkt.io/v1
- type: WebSocket
  url: wss://api.tzkt.io/v1/events
- type: License
  url: https://github.com/baking-bad/tzkt/blob/master/LICENSE
- type: Status
  url: https://tzkt.io
- type: Blog
  url: https://baking-bad.org/blog/
- type: OpenAPI
  url: openapi/openapi.json
- type: Plans
  url: plans/tezos-plans-pricing.yml
- type: RateLimits
  url: rate-limits/tezos-rate-limits.yml
- type: FinOps
  url: finops/tezos-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com