Tezos

Discover Tezos, a self-amending blockchain with on-chain governance. Build decentralized applications using its RPC gateway and flexible architecture.

The Tezos RPC documentation provides developers with a comprehensive guide to interact with the Tezos blockchain programmatically. Tezos is a self-amending blockchain that uses a proof-of-stake (PoS) consensus mechanism and on-chain governance to enable continuous upgrades without requiring hard forks. The documentation includes API endpoints for querying blockchain data, managing transactions, and deploying smart contracts. Tezos’s unique architecture and upgradeable governance make it ideal for decentralized applications (dApps) and decentralized finance (DeFi) projects.

– Related: 📚 Supported Blockchains • 🌐 RPC Nodes → Tezos • 🔗 Official Tezos Website

RPC Gateway for Tezos blockchain

Tezos RPC networks

▶️ Run in Postman 🚀 Get Started

⭐

Tezos Mainnet

🔍 Status 🕵️ Explorer

↳ REST API

https://tezos-mainnet.gateway.tatum.io

📋 Methods

✨

Tezos Shadownet

🔍 Status 🕵️ Explorer

↳ REST API

https://tezos-shadownet.gateway.tatum.io

📋 Methods

Connect to Tezos and Fetch the Latest Block

This widget lets you instantly query the latest block height (or equivalent) for Tezos using a chain-specific RPC method like eth_blockNumber, getblockcount, or getBlockHeight. Useful for connectivity checks, uptime monitoring, or API testing.

Retrieve Tezos Node Status or Client Version via RPC

Use this pre-configured request to get version or status information for your connected Tezos node. Whether it's web3_clientVersion, getblockchaininfo, or chain-specific endpoints, the method is optimized for each supported blockchain.

Test Tezos RPC Methods in Postman

Explore and test Tezos blockchain methods instantly using our pre-configured Postman collection. Perfect for developers who want to experiment with Tezos RPC endpoints, validate API responses, or integrate Tezos into their applications.

How to use the Tezos Postman Collection

Get your API key: Visit Tatum Dashboard to obtain your free API key
Import the collection: Click the "Run in Postman" button below to import the Tezos collection
Configure your environment: Update the gateway-api-key variable in the Tatum Gateway environment
Start testing: Execute any Tezos RPC method and see real-time responses

▶️ Run in Postman

Available Tezos interfaces and methods

Each Tezos network and interface below exposes its own set of RPC methods, listed live from Tatum's RPC Gateway. Query these endpoints for any interface to explore what it supports:

/_methods – machine-readable list of interfaces and methods
/llms.txt – human- and AI-readable documentation context

Tezos Mainnet

REST API · REST

Base URL: https://tezos-mainnet.gateway.tatum.io

Discovery: /_methods · /llms.txt

GET /config
GET /config/history_mode
GET /config/network/dal
GET /errors
GET /fetch_protocol/{protocol_hash}
GET /chains/{chain_id}/blocks
GET /chains/{chain_id}/blocks/{block_id}
GET /chains/{chain_id}/blocks/{block_id}/context/adaptive_issuance_launch_cycle
GET /chains/{chain_id}/blocks/{block_id}/context/big_maps/{id}
GET /chains/{chain_id}/blocks/{block_id}/context/big_maps/{id}/{key_hash}
GET /chains/{chain_id}/blocks/{block_id}/context/constants
GET /chains/{chain_id}/blocks/{block_id}/context/constants/errors
GET /chains/{chain_id}/blocks/{block_id}/context/constants/parametric
GET /chains/{chain_id}/blocks/{block_id}/context/contracts
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/balance_and_frozen_bonds
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/counter
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/delegate
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/entrypoints
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/frozen_bonds
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/full_balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/manager_key
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/script
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/staked_balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage/paid_space
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage/staking_numerator
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage/used_space
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/unstake_requests
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/unstaked_finalizable_balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/unstaked_frozen_balance
GET /chains/{chain_id}/blocks/{block_id}/context/dal/shards
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/active_staking_parameters
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/companion_key
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/consensus_key
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/current_frozen_deposits
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/dal_participation
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/deactivated
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/delegated_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/delegated_contracts
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_balance_by_cycle
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_deposits
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_deposits_limit
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/full_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/grace_period
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/is_forbidden
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/min_delegated_in_current_cycle
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/participation
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/pending_staking_parameters
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/stakers
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/staking_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/staking_denominator
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/total_delegated_stake
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/voting_info
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/voting_power
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/current_yearly_rate
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/current_yearly_rate_details
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/current_yearly_rate_exact
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/expected_issuance
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/issuance_per_minute
GET /chains/{chain_id}/blocks/{block_id}/context/nonces/{block_level}
GET /chains/{chain_id}/blocks/{block_id}/context/seed
GET /chains/{chain_id}/blocks/{block_id}/context/seed_computation
GET /chains/{chain_id}/blocks/{block_id}/context/total_currently_staked
GET /chains/{chain_id}/blocks/{block_id}/context/total_frozen_stake
GET /chains/{chain_id}/blocks/{block_id}/context/total_supply
GET /chains/{chain_id}/blocks/{block_id}/hash
GET /chains/{chain_id}/blocks/{block_id}/header
GET /chains/{chain_id}/blocks/{block_id}/header/protocol_data
GET /chains/{chain_id}/blocks/{block_id}/header/protocol_data/raw
GET /chains/{chain_id}/blocks/{block_id}/header/raw
GET /chains/{chain_id}/blocks/{block_id}/header/shell
GET /chains/{chain_id}/blocks/{block_id}/helpers/attestation_rights
GET /chains/{chain_id}/blocks/{block_id}/helpers/baking_rights
GET /chains/{chain_id}/blocks/{block_id}/helpers/complete/{prefix}
GET /chains/{chain_id}/blocks/{block_id}/helpers/current_level
GET /chains/{chain_id}/blocks/{block_id}/helpers/levels_in_current_cycle
GET /chains/{chain_id}/blocks/{block_id}/helpers/round
GET /chains/{chain_id}/blocks/{block_id}/helpers/total_baking_power
GET /chains/{chain_id}/blocks/{block_id}/helpers/tz4_staker_number_ratio
GET /chains/{chain_id}/blocks/{block_id}/helpers/validators
GET /chains/{chain_id}/blocks/{block_id}/live_blocks
GET /chains/{chain_id}/blocks/{block_id}/metadata
GET /chains/{chain_id}/blocks/{block_id}/operation_hashes
GET /chains/{chain_id}/blocks/{block_id}/operation_hashes/{validation_pass}
GET /chains/{chain_id}/blocks/{block_id}/operation_hashes/{validation_pass}/{operation_offset}
GET /chains/{chain_id}/blocks/{block_id}/operations
GET /chains/{chain_id}/blocks/{block_id}/protocols
GET /chains/{chain_id}/blocks/{block_id}/votes/ballot_list
GET /chains/{chain_id}/blocks/{block_id}/votes/ballots
GET /chains/{chain_id}/blocks/{block_id}/votes/current_period
GET /chains/{chain_id}/blocks/{block_id}/votes/current_proposal
GET /chains/{chain_id}/blocks/{block_id}/votes/current_quorum
GET /chains/{chain_id}/blocks/{block_id}/votes/listings
GET /chains/{chain_id}/blocks/{block_id}/votes/proposals
GET /chains/{chain_id}/blocks/{block_id}/votes/successor_period
GET /chains/{chain_id}/blocks/{block_id}/votes/total_voting_power
GET /chains/{chain_id}/chain_id
GET /chains/{chain_id}/invalid_blocks
GET /chains/{chain_id}/is_bootstrapped
GET /chains/{chain_id}/levels/caboose
GET /chains/{chain_id}/levels/checkpoint
GET /chains/{chain_id}/levels/savepoint
GET /chains/{chain_id}/mempool/filter
GET /chains/{chain_id}/mempool/pending_operations
GET /chains/main/chain_id
GET /protocols
GET /protocols/{protocol_hash}
GET /version
GET /versions
POST /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/all_ticket_balances
POST /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/big_map_get
POST /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/ticket_balance
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge_block_header
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge/consensus_operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge/operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge/signed_operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/parse/operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/preapply/block
POST /chains/{chain_id}/blocks/{block_id}/helpers/preapply/operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/scripts/event_address
POST /chains/{chain_id}/blocks/{block_id}/helpers/scripts/run_operation
POST /chains/{chain_id}/blocks/{block_id}/helpers/scripts/simulate_operation
POST /chains/{chain_id}/mempool/filter
POST /injection/operation

Tezos Shadownet

REST API · REST

Base URL: https://tezos-shadownet.gateway.tatum.io

Discovery: /_methods · /llms.txt

GET /config
GET /config/history_mode
GET /config/network/dal
GET /errors
GET /fetch_protocol/{protocol_hash}
GET /chains/{chain_id}/blocks
GET /chains/{chain_id}/blocks/{block_id}
GET /chains/{chain_id}/blocks/{block_id}/context/adaptive_issuance_launch_cycle
GET /chains/{chain_id}/blocks/{block_id}/context/big_maps/{id}
GET /chains/{chain_id}/blocks/{block_id}/context/big_maps/{id}/{key_hash}
GET /chains/{chain_id}/blocks/{block_id}/context/constants
GET /chains/{chain_id}/blocks/{block_id}/context/constants/errors
GET /chains/{chain_id}/blocks/{block_id}/context/constants/parametric
GET /chains/{chain_id}/blocks/{block_id}/context/contracts
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/balance_and_frozen_bonds
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/counter
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/delegate
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/entrypoints
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/frozen_bonds
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/full_balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/manager_key
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/script
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/staked_balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage/paid_space
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage/staking_numerator
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/storage/used_space
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/unstake_requests
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/unstaked_finalizable_balance
GET /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/unstaked_frozen_balance
GET /chains/{chain_id}/blocks/{block_id}/context/dal/shards
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/active_staking_parameters
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/companion_key
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/consensus_key
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/current_frozen_deposits
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/dal_participation
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/deactivated
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/delegated_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/delegated_contracts
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_balance_by_cycle
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_deposits
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/frozen_deposits_limit
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/full_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/grace_period
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/is_forbidden
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/min_delegated_in_current_cycle
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/participation
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/pending_staking_parameters
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/stakers
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/staking_balance
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/staking_denominator
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/total_delegated_stake
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/voting_info
GET /chains/{chain_id}/blocks/{block_id}/context/delegates/{pkh}/voting_power
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/current_yearly_rate
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/current_yearly_rate_details
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/current_yearly_rate_exact
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/expected_issuance
GET /chains/{chain_id}/blocks/{block_id}/context/issuance/issuance_per_minute
GET /chains/{chain_id}/blocks/{block_id}/context/nonces/{block_level}
GET /chains/{chain_id}/blocks/{block_id}/context/seed
GET /chains/{chain_id}/blocks/{block_id}/context/seed_computation
GET /chains/{chain_id}/blocks/{block_id}/context/total_currently_staked
GET /chains/{chain_id}/blocks/{block_id}/context/total_frozen_stake
GET /chains/{chain_id}/blocks/{block_id}/context/total_supply
GET /chains/{chain_id}/blocks/{block_id}/hash
GET /chains/{chain_id}/blocks/{block_id}/header
GET /chains/{chain_id}/blocks/{block_id}/header/protocol_data
GET /chains/{chain_id}/blocks/{block_id}/header/protocol_data/raw
GET /chains/{chain_id}/blocks/{block_id}/header/raw
GET /chains/{chain_id}/blocks/{block_id}/header/shell
GET /chains/{chain_id}/blocks/{block_id}/helpers/attestation_rights
GET /chains/{chain_id}/blocks/{block_id}/helpers/baking_rights
GET /chains/{chain_id}/blocks/{block_id}/helpers/complete/{prefix}
GET /chains/{chain_id}/blocks/{block_id}/helpers/current_level
GET /chains/{chain_id}/blocks/{block_id}/helpers/levels_in_current_cycle
GET /chains/{chain_id}/blocks/{block_id}/helpers/round
GET /chains/{chain_id}/blocks/{block_id}/helpers/total_baking_power
GET /chains/{chain_id}/blocks/{block_id}/helpers/tz4_staker_number_ratio
GET /chains/{chain_id}/blocks/{block_id}/helpers/validators
GET /chains/{chain_id}/blocks/{block_id}/live_blocks
GET /chains/{chain_id}/blocks/{block_id}/metadata
GET /chains/{chain_id}/blocks/{block_id}/operation_hashes
GET /chains/{chain_id}/blocks/{block_id}/operation_hashes/{validation_pass}
GET /chains/{chain_id}/blocks/{block_id}/operation_hashes/{validation_pass}/{operation_offset}
GET /chains/{chain_id}/blocks/{block_id}/operations
GET /chains/{chain_id}/blocks/{block_id}/protocols
GET /chains/{chain_id}/blocks/{block_id}/votes/ballot_list
GET /chains/{chain_id}/blocks/{block_id}/votes/ballots
GET /chains/{chain_id}/blocks/{block_id}/votes/current_period
GET /chains/{chain_id}/blocks/{block_id}/votes/current_proposal
GET /chains/{chain_id}/blocks/{block_id}/votes/current_quorum
GET /chains/{chain_id}/blocks/{block_id}/votes/listings
GET /chains/{chain_id}/blocks/{block_id}/votes/proposals
GET /chains/{chain_id}/blocks/{block_id}/votes/successor_period
GET /chains/{chain_id}/blocks/{block_id}/votes/total_voting_power
GET /chains/{chain_id}/chain_id
GET /chains/{chain_id}/invalid_blocks
GET /chains/{chain_id}/is_bootstrapped
GET /chains/{chain_id}/levels/caboose
GET /chains/{chain_id}/levels/checkpoint
GET /chains/{chain_id}/levels/savepoint
GET /chains/{chain_id}/mempool/filter
GET /chains/{chain_id}/mempool/pending_operations
GET /chains/main/chain_id
GET /protocols
GET /protocols/{protocol_hash}
GET /version
GET /versions
POST /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/all_ticket_balances
POST /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/big_map_get
POST /chains/{chain_id}/blocks/{block_id}/context/contracts/{contract_id}/ticket_balance
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge_block_header
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge/consensus_operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge/operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/forge/signed_operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/parse/operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/preapply/block
POST /chains/{chain_id}/blocks/{block_id}/helpers/preapply/operations
POST /chains/{chain_id}/blocks/{block_id}/helpers/scripts/event_address
POST /chains/{chain_id}/blocks/{block_id}/helpers/scripts/run_operation
POST /chains/{chain_id}/blocks/{block_id}/helpers/scripts/simulate_operation
POST /chains/{chain_id}/mempool/filter
POST /injection/operation

Method unavailable?
If you need a method we don't support yet, please contact our support.
We'd be happy to assist.