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
deliveryModel:
  model: saas
  license_evidence:
    not_product:
    - baking-bad/tzkt
  open_source: unknown
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: low
  source:
  - openapi
  - pricing
  - repository-not-product
  generated: '2026-09-25'
  method: derived
accessModel:
  pricing: freemium
  onboarding: open
  trial: false
  try_now: true
  public: true
  label: Freemium · Open access
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Producing
access: Public
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/tezos.png
x-docs-platform: redocly
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-10-17
tags:
  - Tezos
  - Blockchain
  - TzKT
  - Baking Bad
  - Cryptocurrency
  - Smart Contracts
  - NFT
  - Tokens
  - Delegation
  - Staking
  - Governance
  - FA1.2
  - FA2
  - WebSocket
tags_raw:
  - 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.23'
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:
  - Account
  - Balances
  - Wallets
  - Delegates
  tags_raw:
  - 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
  tags_raw:
  - 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:
  - Transaction
  - Originations
  - Delegation
  - Endorsements
  tags_raw:
  - 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
  - Event
  tags_raw:
  - 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:
  - Delegation
  - Staking
  - Baking
  - Rewards
  - Validator
  tags_raw:
  - 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:
  - Protocol
  - Chain Constants
  - History
  tags_raw:
  - 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
  - Subscription
  - Event
  - SignalR
  tags_raw:
  - WebSocket
  - Real-Time
  - Subscriptions
  - Events
  - SignalR
  properties:
  - type: Documentation
    url: https://api.tzkt.io/#tag/WebSocket
- aid: tezos:tezos-accounts-api
  name: Tezos Accounts API
  description: The Accounts API from Tezos — 12 operation(s) for accounts.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Account
  tags_raw:
  - Accounts
  properties:
  - type: OpenAPI
    url: openapi/tezos-accounts-api-openapi.yml
- aid: tezos:tezos-bigmaps-api
  name: Tezos BigMaps API
  description: The BigMaps API from Tezos — 12 operation(s) for bigmaps.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Big Maps
  tags_raw:
  - BigMaps
  properties:
  - type: OpenAPI
    url: openapi/tezos-bigmaps-api-openapi.yml
- aid: tezos:tezos-blocks-api
  name: Tezos Blocks API
  description: The Blocks API from Tezos — 7 operation(s) for blocks.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Blocks
  properties:
  - type: OpenAPI
    url: openapi/tezos-blocks-api-openapi.yml
- aid: tezos:tezos-commitments-api
  name: Tezos Commitments API
  description: The Commitments API from Tezos — 3 operation(s) for commitments.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Commitments
  properties:
  - type: OpenAPI
    url: openapi/tezos-commitments-api-openapi.yml
- aid: tezos:tezos-constants-api
  name: Tezos Constants API
  description: The Constants API from Tezos — 3 operation(s) for constants.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Constants
  properties:
  - type: OpenAPI
    url: openapi/tezos-constants-api-openapi.yml
- aid: tezos:tezos-contracts-api
  name: Tezos Contracts API
  description: The Contracts API from Tezos — 25 operation(s) for contracts.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Contracts
  properties:
  - type: OpenAPI
    url: openapi/tezos-contracts-api-openapi.yml
- aid: tezos:tezos-cycles-api
  name: Tezos Cycles API
  description: The Cycles API from Tezos — 3 operation(s) for cycles.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Cycles
  properties:
  - type: OpenAPI
    url: openapi/tezos-cycles-api-openapi.yml
- aid: tezos:tezos-delegates-api
  name: Tezos Delegates API
  description: The Delegates API from Tezos — 3 operation(s) for delegates.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Delegates
  properties:
  - type: OpenAPI
    url: openapi/tezos-delegates-api-openapi.yml
- aid: tezos:tezos-domains-api
  name: Tezos Domains API
  description: The Domains API from Tezos — 3 operation(s) for domains.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Domains
  properties:
  - type: OpenAPI
    url: openapi/tezos-domains-api-openapi.yml
- aid: tezos:tezos-events-api
  name: Tezos Events API
  description: The Events API from Tezos — 2 operation(s) for events.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/tezos-events-api-openapi.yml
- aid: tezos:tezos-head-api
  name: Tezos Head API
  description: The Head API from Tezos — 1 operation(s) for head.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags: []
  tags_raw:
  - Head
  properties:
  - type: OpenAPI
    url: openapi/tezos-head-api-openapi.yml
- aid: tezos:tezos-helpers-api
  name: Tezos Helpers API
  description: The Helpers API from Tezos — 2 operation(s) for helpers.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Helpers
  properties:
  - type: OpenAPI
    url: openapi/tezos-helpers-api-openapi.yml
- aid: tezos:tezos-operations-api
  name: Tezos Operations API
  description: The Operations API from Tezos — 142 operation(s) for operations.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags: []
  tags_raw:
  - Operations
  properties:
  - type: OpenAPI
    url: openapi/tezos-operations-api-openapi.yml
- aid: tezos:tezos-protocols-api
  name: Tezos Protocols API
  description: The Protocols API from Tezos — 6 operation(s) for protocols.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Protocol
  tags_raw:
  - Protocols
  properties:
  - type: OpenAPI
    url: openapi/tezos-protocols-api-openapi.yml
- aid: tezos:tezos-quotes-api
  name: Tezos Quotes API
  description: The Quotes API from Tezos — 3 operation(s) for quotes.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Quotes
  properties:
  - type: OpenAPI
    url: openapi/tezos-quotes-api-openapi.yml
- aid: tezos:tezos-rewards-api
  name: Tezos Rewards API
  description: The Rewards API from Tezos — 8 operation(s) for rewards.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Rewards
  properties:
  - type: OpenAPI
    url: openapi/tezos-rewards-api-openapi.yml
- aid: tezos:tezos-rights-api
  name: Tezos Rights API
  description: The Rights API from Tezos — 2 operation(s) for rights.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Rights
  properties:
  - type: OpenAPI
    url: openapi/tezos-rights-api-openapi.yml
- aid: tezos:tezos-smartrollups-api
  name: Tezos SmartRollups API
  description: The SmartRollups API from Tezos — 12 operation(s) for smartrollups.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - SmartRollups
  properties:
  - type: OpenAPI
    url: openapi/tezos-smartrollups-api-openapi.yml
- aid: tezos:tezos-software-api
  name: Tezos Software API
  description: The Software API from Tezos — 2 operation(s) for software.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Software
  properties:
  - type: OpenAPI
    url: openapi/tezos-software-api-openapi.yml
- aid: tezos:tezos-staking-api
  name: Tezos Staking API
  description: The Staking API from Tezos — 4 operation(s) for staking.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Staking
  properties:
  - type: OpenAPI
    url: openapi/tezos-staking-api-openapi.yml
- aid: tezos:tezos-statistics-api
  name: Tezos Statistics API
  description: The Statistics API from Tezos — 4 operation(s) for statistics.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Statistics
  properties:
  - type: OpenAPI
    url: openapi/tezos-statistics-api-openapi.yml
- aid: tezos:tezos-tickets-api
  name: Tezos Tickets API
  description: The Tickets API from Tezos — 7 operation(s) for tickets.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Ticketing
  tags_raw:
  - Tickets
  properties:
  - type: OpenAPI
    url: openapi/tezos-tickets-api-openapi.yml
- aid: tezos:tezos-tokens-api
  name: Tezos Tokens API
  description: The Tokens API from Tezos — 7 operation(s) for tokens.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Tokens
  properties:
  - type: OpenAPI
    url: openapi/tezos-tokens-api-openapi.yml
- aid: tezos:tezos-voting-api
  name: Tezos Voting API
  description: The Voting API from Tezos — 14 operation(s) for voting.
  humanURL: https://api.tzkt.io/#tag/Accounts
  baseURL: https://api.tzkt.io/v1
  tags:
  - Voting
  properties:
  - type: OpenAPI
    url: openapi/tezos-voting-api-openapi.yml
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: CapabilityMap
    url: capabilities/tezos-capability-edges.yml
    name: Tezos Business Capability Map
  - type: IssueTracker
    url: https://github.com/baking-bad/tzkt/issues
  - type: Releases
    url: https://github.com/baking-bad/tzkt/releases
  - type: AgenticAccess
    url: agentic-access/tezos-agentic-access.yml
  - type: DomainSecurity
    url: security/tezos-domain-security.yml
  - 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: 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/_original/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
