TzKT

App · 20 actions

Read the Tezos blockchain through TzKT, the explorer by Baking Bad: account balances and balance history, transactions and operations, blocks and cycles, tokens and NFTs with their holders and transfers, smart contract entrypoints and storage, bakers, network statistics, the XTZ price and Tezos Domains names, on Mainnet or Shadownet. Start a workflow when an account has a new transaction or token transfer. No account or API key required. Data provided by TzKT API (https://tzkt.io).

Actions

ActionWhat it does
Find an address's domainsFind the Tezos Domains names that point to an address, with its primary name (the one wallets show for it) first, when each expires and who owns it.
Find tokensFind Tezos tokens and NFTs whose symbol or name contains some text, or every token of a contract, the most held first, with each one's contract, id, decimals, supply and number of holders.
Get accountGet a Tezos account by its address or .tez name: its balance in tez (spendable, staked and being unstaked) and what it is worth now, its baker, whether it is a wallet, a baker or a contract, how many transactions and tokens it has, and for a baker its baking power, delegators and stakers.
Get balance historyList an account's tez balance each time it changed, newest first, with the XTZ price then and what the balance was worth.
Get balance on a dateGet an account's tez balance at a past moment, such as the end of a tax year, with the XTZ price then and what the balance was worth.
Get blockGet a Tezos block: the latest, one by its level or hash, or the last one made at or before a moment.
Get contract storageRead a smart contract's storage as JSON: all of it or one field, now or as it was at a past moment or block.
Get cycleGet a Tezos cycle, the period bakers' rights and rewards are set for (about a day on Mainnet): the current one or one by number, with its first and last blocks, when it starts and ends, how far through it the chain is, and its rewards.
Get network statisticsGet the tez supply now or at the end of a past day: total and circulating supply, tez created, burned and frozen, how much is staked and delegated, and how many bakers, stakers and delegators there are.
Get operationGet a Tezos operation by its hash: whether it went through, who sent it, its fees, and every part of it (transfers, contract calls and what those calls did in turn) with why a part failed.
Get smart contractGet a Tezos smart contract: its name, the standards it implements (such as FA2), its balance, who deployed it and when, how many transactions and tokens it has, and what its own metadata says about it.
Get tokenGet a Tezos token or NFT by its contract and id: its name, symbol, decimals, supply in whole tokens, how many hold it and have moved it, who minted it first, and its pictures.
Get XTZ priceGet the price of one tez (XTZ) in US dollars, euros, pounds, yen, yuan, won, bitcoin and ether, now or at a past moment, as TzKT records it with every block.
List account tokensList the tokens and NFTs an account holds, the most recently changed first, each with its name, symbol and balance in whole tokens.
List bakersList the active Tezos bakers, ranked by baking power, delegators or stakers, with each one's stake, how many delegate and stake with it, whether it takes stakers and how much more, and the share of stakers' rewards it keeps.
List contract entrypointsList a smart contract's entrypoints (the calls it takes, such as transfer or mint), each with an outline of the fields it expects.
List token holdersList the accounts holding a token, the biggest first, with each one's balance in whole tokens and its share of the supply.
List token transfersList token and NFT transfers, newest first: of one account (only received or sent if you like), of one token or contract, or both, optionally between two moments.
List transactionsList Tezos transactions, newest first: of one account or the whole network, optionally only those it received or sent, only those with one other account, only transfers of tez or only contract calls (to one entrypoint), only one outcome, from an amount up, or between two moments.
Look up a Tezos domainLook up a Tezos Domains name, such as baking-bad.tez: the address it points to, who owns it, when it expires and what its owner attached to it.

Find an address's domains

Find the Tezos Domains names that point to an address, with its primary name (the one wallets show for it) first, when each expires and who owns it.

Inputs

AddressaddresstextRequired
The address (tz1..., KT1...).

Outputs

addresstext
The address read.
countnumber
How many are listed.
domainslist
The names pointing to it: the primary one first, expired ones last.
primary_domaintext
Its primary name, the one wallets show for it, when it has one.
Example output
{
  "address": "tz1TPXFXctCyJ6ZLBo2kbb9EPkEQdcVUN1rB",
  "count": 2,
  "domains": [
    {
      "expired": false,
      "expires_at": "2028-04-28T00:00:00Z",
      "is_primary": true,
      "name": "baking-bad.tez",
      "owner_address": "tz1TPXFXctCyJ6ZLBo2kbb9EPkEQdcVUN1rB",
      "tezos_domains_url": "https://app.tezos.domains/domain/baking-bad.tez"
    },
    {
      "expired": false,
      "expires_at": "2028-04-28T00:00:00Z",
      "is_primary": false,
      "name": "atomex.tez",
      "owner_address": "tz1TPXFXctCyJ6ZLBo2kbb9EPkEQdcVUN1rB",
      "tezos_domains_url": "https://app.tezos.domains/domain/atomex.tez"
    }
  ],
  "primary_domain": "baking-bad.tez"
}

Find tokens

Find Tezos tokens and NFTs whose symbol or name contains some text, or every token of a contract, the most held first, with each one's contract, id, decimals, supply and number of holders. Anyone can name a token anything, so check the contract before trusting one.

Inputs

Searchsearchtext
Part of the token's symbol or name, in any case, such as USDt, or a contract address for its tokens. Leave empty for the most held tokens.
Token standardstandardtext
Only tokens of this standard. Leave empty for both.One of: fa1.2 (FA1.2 (one token per contract)), fa2 (FA2 (several tokens or NFTs per contract)).
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

countnumber
How many are listed.
more_availabletrue/false
True when the list stopped at the number asked for, so more may exist.
networktext
The network read: mainnet or shadownet.
searchtext
The text searched for.
tokenslist
The tokens found, the most held first. Anyone can name a token anything, so check the contract.
Example output
{
  "count": 2,
  "more_available": true,
  "network": "mainnet",
  "search": "USDt",
  "tokens": [
    {
      "contract_address": "KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9",
      "contract_alias": "USDtz",
      "decimals": 6,
      "first_time": "2020-05-04T20:41:28Z",
      "holders_count": 5117,
      "last_time": "2026-10-23T23:18:01Z",
      "name": "USDtez",
      "standard": "fa1.2",
      "symbol": "USDtz",
      "thumbnail_uri": null,
      "token_id": "0",
      "total_supply": 223592.318855,
      "total_supply_raw": "223592318855",
      "transfers_count": 503072,
      "tzkt_url": "https://tzkt.io/KT1LN4LPSqTMS7Sd2CJw4bbDGRkMv2t68Fy9/tokens/0"
    },
    {
      "contract_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
      "contract_alias": "Tether Token",
      "decimals": 6,
      "first_time": "2022-06-30T13:12:59Z",
      "holders_count": 3318,
      "last_time": "2026-10-23T23:19:31Z",
      "name": "Tether USD",
      "standard": "fa2",
      "symbol": "USDt",
      "thumbnail_uri": "ipfs://QmRymVGWEudMfLrbjaEiXxngCRTDgWCsscjQMwizy4ZJjX",
      "token_id": "0",
      "total_supply": 141000001.0,
      "total_supply_raw": "141000001000000",
      "transfers_count": 1020437,
      "tzkt_url": "https://tzkt.io/KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o/tokens/0"
    }
  ]
}

Get account

Get a Tezos account by its address or .tez name: its balance in tez (spendable, staked and being unstaked) and what it is worth now, its baker, whether it is a wallet, a baker or a contract, how many transactions and tokens it has, and for a baker its baking power, delegators and stakers.

Inputs

AccountaddresstextRequired
The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
Value incurrencytext
The currency to give prices and values in. Defaults to US dollars.One of: usd (US dollar (USD)), eur (Euro (EUR)), gbp (British pound (GBP)), jpy (Japanese yen (JPY)), cny (Chinese yuan (CNY)), krw (South Korean won (KRW)), btc (Bitcoin (BTC)), eth (Ether (ETH)). Default: usd.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

addresstext
The account's address.
aliastext
The name TzKT knows it by, when it has one.
baker_activetrue/false
For a baker: whether it is baking now.
baking_power_teznumber
For a baker: its baking power in tez.
balance_muteznumber
The same balance in mutez (1 tez is 1,000,000 mutez).
balance_teznumber
Everything it holds in tez: spendable, staked and being unstaked.
contract_kindtext
For a smart contract: TzKT's kind, such as asset (a token contract), smart_contract or delegator_contract.
contracts_countnumber
How many smart contracts it has deployed.
currencytext
The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
delegate_addresstext
The baker it delegates to, if any.
delegate_aliastext
That baker's name.
delegated_sincetext
When it last chose its baker, ISO 8601.
delegators_countnumber
For a baker: how many delegate to it.
external_delegated_teznumber
For a baker: tez others delegated to it.
external_staked_teznumber
For a baker: tez others staked with it.
first_activity_timetext
When it was first used, ISO 8601.
is_bakertrue/false
True for a baker (a registered delegate).
last_activity_timetext
When it last changed, ISO 8601.
networktext
The network read: mainnet or shadownet.
pricenumber
The price of one tez in that currency now. Empty on a test network.
revealedtrue/false
Whether its public key is on the chain, which an account needs before it can send anything.
spendable_teznumber
The tez it can spend or send now.
staked_teznumber
Its tez staked with its baker (or, for a baker, its own stake).
stakers_countnumber
For a baker: how many stake with it.
tokens_held_countnumber
How many different tokens and NFTs it holds.
transactions_countnumber
How many transactions it has taken part in.
typetext
What it is: user (a wallet), delegate (a baker), contract (a smart contract), ghost (a contract address that was never deployed), rollup, smart_rollup, or empty (never used).
tzkt_urltext
Its page on TzKT, the Tezos explorer.
unstaked_teznumber
Tez it unstaked that are still frozen, waiting to become spendable.
valuenumber
What its whole balance is worth now in that currency. Empty on a test network.
Example output
{
  "address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "alias": "Kraken Baker",
  "baker_active": true,
  "baking_power_tez": 62918893.910944,
  "balance_mutez": 6801442622476,
  "balance_tez": 6801442.622476,
  "contract_kind": null,
  "contracts_count": 0,
  "currency": "usd",
  "delegate_address": null,
  "delegate_alias": null,
  "delegated_since": null,
  "delegators_count": 3866,
  "external_delegated_tez": 8669028.776655,
  "external_staked_tez": 53365086.417067,
  "first_activity_time": "2018-07-19T18:48:27Z",
  "is_baker": true,
  "last_activity_time": "2026-10-24T00:19:16Z",
  "network": "mainnet",
  "price": 0.3034500771992988,
  "revealed": true,
  "spendable_tez": 205967.081226,
  "staked_tez": 6595475.54125,
  "stakers_count": 100,
  "tokens_held_count": 10,
  "transactions_count": 11827,
  "type": "delegate",
  "tzkt_url": "https://tzkt.io/tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "unstaked_tez": 0.0,
  "value": 2063898.28885694
}

Get balance history

List an account's tez balance each time it changed, newest first, with the XTZ price then and what the balance was worth. For an account staking with a baker the staked tez are left out.

Inputs

AccountaddresstextRequired
The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
Value incurrencytext
The currency to give prices and values in. Defaults to US dollars.One of: usd (US dollar (USD)), eur (Euro (EUR)), gbp (British pound (GBP)), jpy (Japanese yen (JPY)), cny (Chinese yuan (CNY)), krw (South Korean won (KRW)), btc (Bitcoin (BTC)), eth (Ether (ETH)). Default: usd.
Orderordertext
Newest or oldest first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

addresstext
The account read.
countnumber
How many are listed.
currencytext
The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
more_availabletrue/false
True when the list stopped at the number asked for, so more may exist.
networktext
The network read: mainnet or shadownet.
pointslist
The balance each time it changed.
Example output
{
  "address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "count": 2,
  "currency": "usd",
  "more_available": true,
  "network": "mainnet",
  "points": [
    {
      "balance_mutez": 6801442622476,
      "balance_tez": 6801442.622476,
      "level": 15504596,
      "price": 0.3034500771992988,
      "timestamp": "2026-10-24T00:18:28Z",
      "value": 2063898.28885694
    },
    {
      "balance_mutez": 6801441841416,
      "balance_tez": 6801441.841416,
      "level": 15504588,
      "price": 0.3034500771992988,
      "timestamp": "2026-10-24T00:17:40Z",
      "value": 2063898.05184423
    }
  ]
}

Get balance on a date

Get an account's tez balance at a past moment, such as the end of a tax year, with the XTZ price then and what the balance was worth. For an account staking with a baker the staked tez are left out.

Inputs

AccountaddresstextRequired
The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
Atatdate and timeRequired
The moment to read the balance at.
Value incurrencytext
The currency to give prices and values in. Defaults to US dollars.One of: usd (US dollar (USD)), eur (Euro (EUR)), gbp (British pound (GBP)), jpy (Japanese yen (JPY)), cny (Chinese yuan (CNY)), krw (South Korean won (KRW)), btc (Bitcoin (BTC)), eth (Ether (ETH)). Default: usd.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

addresstext
The account read.
attext
The moment asked about, ISO 8601 in UTC.
balance_muteznumber
The same balance in mutez.
balance_teznumber
Its balance then, in tez. For an account staking with a baker this leaves its staked tez out.
currencytext
The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
networktext
The network read: mainnet or shadownet.
pricenumber
The price of one tez in that currency at the time. Empty on a test network.
price_timetext
When that price was recorded, ISO 8601.
valuenumber
The tez amount times that price: what it was worth then. Empty on a test network.
Example output
{
  "address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "at": "2025-12-31T23:59:59Z",
  "balance_mutez": 4217978946119,
  "balance_tez": 4217978.946119,
  "currency": "usd",
  "network": "mainnet",
  "price": 0.4943868261169391,
  "price_time": "2025-12-31T23:59:56Z",
  "value": 2085313.22379984
}

Get block

Get a Tezos block: the latest, one by its level or hash, or the last one made at or before a moment. Gives its time, cycle, the baker who made it, its fees and rewards and how many transactions it holds.

Inputs

Blockblocktext
The block's level, such as 15504379, or its hash (starting with B). Leave empty for the latest block.
Closest toatdate and time
Instead of a block: the last block made at or before this moment.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

attestation_committeenumber
The size of the committee.
attestation_powernumber
How much of the committee attested it.
block_roundnumber
The round it was made in (0 is on time).
cyclenumber
The cycle it is in.
fees_teznumber
The fees of every operation in it, in tez.
hashtext
The block's hash.
is_latesttrue/false
True when it is the newest block.
latest_levelnumber
The newest block's level when it was read.
levelnumber
The block's level (its height in the chain).
networktext
The network read: mainnet or shadownet.
payload_roundnumber
The round its contents were proposed in.
producer_addresstext
The producer's address.
producer_aliastext
The name TzKT knows the producer by, such as an exchange or a dapp, when it has one.
proposer_addresstext
The proposer's address.
proposer_aliastext
The name TzKT knows the proposer by, such as an exchange or a dapp, when it has one.
protocol_codenumber
Which protocol upgrade it was made under, counted from the start.
rewards_teznumber
The rewards paid for it, in tez.
timestamptext
When it was made, ISO 8601.
transactions_countnumber
How many transactions it holds.
tzkt_urltext
Its page on TzKT, the Tezos explorer.
Example output
{
  "attestation_committee": 7000,
  "attestation_power": 6990,
  "block_round": 0,
  "cycle": 1392,
  "fees_tez": 0.148838,
  "hash": "BMANcEDvJZriHHSEG47NH8EuWAjvua6Xd5SteJoQL3FRk9t98zS",
  "is_latest": false,
  "latest_level": 15504607,
  "level": 15504379,
  "network": "mainnet",
  "payload_round": 0,
  "producer_address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "producer_alias": "Kraken Baker",
  "proposer_address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "proposer_alias": "Kraken Baker",
  "protocol_code": 25,
  "rewards_tez": 2.678407,
  "timestamp": "2026-10-23T23:56:37Z",
  "transactions_count": 183,
  "tzkt_url": "https://tzkt.io/15504379"
}

Get contract storage

Read a smart contract's storage as JSON: all of it or one field, now or as it was at a past moment or block.

Inputs

ContractcontracttextRequired
The contract's address (KT1...).
Fieldpathtext
Only this field of the storage, with dots for one inside another, such as total_supply or settings.fee. Leave empty for all of it.
As ofatdate and time
Read it as it was at this moment. Leave empty for now.
As of blocklevelnumber
Instead of a moment: read it as it was at this block level.At least 1.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

contracttext
The contract read.
levelnumber
The block it was read at; empty for now.
networktext
The network read: mainnet or shadownet.
pathtext
The part of the storage read; empty for all of it.
storageobject
The storage as JSON. A big map shows as its number, which TzKT's big map pages take.
Example output
{
  "contract": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
  "level": null,
  "network": "mainnet",
  "path": "total_supply",
  "storage": 198035
}

Get cycle

Get a Tezos cycle, the period bakers' rights and rewards are set for (about a day on Mainnet): the current one or one by number, with its first and last blocks, when it starts and ends, how far through it the chain is, and its rewards.

Inputs

Cyclecyclenumber
The cycle's number. Leave empty for the current cycle.At least 0.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

attestation_reward_per_block_teznumber
The rewards for attesting one block, shared by its attesters, in tez.
block_bonus_teznumber
The bonus for making a block, in tez.
block_reward_teznumber
The reward for proposing a block, in tez.
end_timetext
When it ends, ISO 8601 (expected, for one under way).
first_levelnumber
Its first block.
indexnumber
The cycle's number.
is_currenttrue/false
True for the cycle under way.
last_levelnumber
Its last block.
networktext
The network read: mainnet or shadownet.
progress_percentnumber
How far through it the chain is, 0 to 100.
snapshot_levelnumber
The block whose stakes decided who bakes in it.
start_timetext
When it starts, ISO 8601.
total_bakersnumber
How many bakers take part.
total_baking_power_teznumber
Their baking power together, in tez.
Example output
{
  "attestation_reward_per_block_tez": 2.685366,
  "block_bonus_tez": 1.342682,
  "block_reward_tez": 1.342682,
  "end_time": "2026-10-24T15:47:40Z",
  "first_level": 15499489,
  "index": 1392,
  "is_current": true,
  "last_level": 15513888,
  "network": "mainnet",
  "progress_percent": 35.55,
  "snapshot_level": 15470688,
  "start_time": "2026-10-23T15:40:31Z",
  "total_bakers": 199,
  "total_baking_power_tez": 453950629.263033
}

Get network statistics

Get the tez supply now or at the end of a past day: total and circulating supply, tez created, burned and frozen, how much is staked and delegated, and how many bakers, stakers and delegators there are.

Inputs

Ondatedate
A past day, to read the figures at its end. Leave empty for now.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

bakers_countnumber
Active bakers.
circulating_supply_teznumber
Tez that can move (not locked), in tez.
datetext
The day read, for a past day. Empty for now.
delegators_countnumber
Accounts delegating to a baker.
levelnumber
The block the figures are from.
networktext
The network read: mainnet or shadownet.
sent_to_null_address_teznumber
Tez sent to the null address, which no one can spend, in tez.
staked_percentnumber
Staked tez as a share of circulating tez.
stakers_countnumber
Accounts staking with a baker.
timestamptext
That block's time, ISO 8601.
total_baking_power_teznumber
All bakers' baking power, in tez.
total_burned_teznumber
Tez burned for fees and storage, in tez.
total_created_teznumber
Tez created since the start (rewards), in tez.
total_delegated_teznumber
Tez delegated to bakers, in tez.
total_frozen_teznumber
Tez frozen as stake or deposits, in tez.
total_staked_teznumber
Tez staked by bakers and their stakers, in tez.
total_supply_teznumber
All tez there are, in tez.
Example output
{
  "bakers_count": 199,
  "circulating_supply_tez": 1099541728.463561,
  "date": "2026-10-22",
  "delegators_count": 140750,
  "level": 15490214,
  "network": "mainnet",
  "sent_to_null_address_tez": 551811.963347,
  "staked_percent": 31.79,
  "stakers_count": 3226,
  "timestamp": "2026-10-22T23:59:58Z",
  "total_baking_power_tez": 454159199.161503,
  "total_burned_tez": 2322946.911306,
  "total_created_tez": 358042960.70433,
  "total_delegated_tez": 314653818.590704,
  "total_frozen_tez": 354525474.645332,
  "total_staked_tez": 349591626.138508,
  "total_supply_tez": 1119486799.842377
}

Get operation

Get a Tezos operation by its hash: whether it went through, who sent it, its fees, and every part of it (transfers, contract calls and what those calls did in turn) with why a part failed.

Inputs

Operation hashoperation_hashtextRequired
The operation's hash: 51 characters starting with o, as a wallet or TzKT shows it. A TzKT link works too.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

amount_teznumber
The tez its transactions moved, added up.
blocktext
The block's hash.
countnumber
How many parts it has, those contracts made included.
fee_teznumber
Every fee paid for it, in tez.
hashtext
The operation hash.
levelnumber
The block it is in.
networktext
The network read: mainnet or shadownet.
operationslist
Each part, in order.
sender_addresstext
The sender's address.
sender_aliastext
The name TzKT knows the sender by, such as an exchange or a dapp, when it has one.
statustext
How it ended: applied when every part went through, failed when a part failed (undoing the rest).
succeededtrue/false
True when every part was applied.
timestamptext
When, ISO 8601.
tzkt_urltext
Its page on TzKT, the Tezos explorer.
Example output
{
  "amount_tez": 0.0,
  "block": "BMH4DdzzwixmWFHNY1wMx5XPvz261KsJfZ5bzcFrKSUmnGQWmNc",
  "count": 1,
  "fee_tez": 0.000897,
  "hash": "onq9ffwQAWzwzBCeCkyVXiwcfwLeJjknqd9sZyTf8fwiTaF2pzS",
  "level": 15504011,
  "network": "mainnet",
  "operations": [
    {
      "amount_tez": 0.0,
      "baker_fee_tez": 0.000897,
      "delegate_address": null,
      "delegate_alias": null,
      "entrypoint": "transfer",
      "errors": [],
      "gas_used": 3451,
      "id": 2996519816921088,
      "is_internal": false,
      "parameter": [
        {
          "from_": "tz1ftMpsP4KdtJdK6j1owQshrv8co6cgpP1C",
          "txs": [
            {
              "amount": "1542728868",
              "to_": "tz2FjD9wYiGzz97aJv6qJvQyAsoULhaTaVu9",
              "token_id": "0"
            }
          ]
        }
      ],
      "sender_address": "tz1ftMpsP4KdtJdK6j1owQshrv8co6cgpP1C",
      "sender_alias": null,
      "status": "applied",
      "storage_fee_tez": 0.0,
      "target_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
      "target_alias": "Tether Token",
      "type": "transaction"
    }
  ],
  "sender_address": "tz1ftMpsP4KdtJdK6j1owQshrv8co6cgpP1C",
  "sender_alias": null,
  "status": "applied",
  "succeeded": true,
  "timestamp": "2026-10-23T23:19:31Z",
  "tzkt_url": "https://tzkt.io/onq9ffwQAWzwzBCeCkyVXiwcfwLeJjknqd9sZyTf8fwiTaF2pzS"
}

Get smart contract

Get a Tezos smart contract: its name, the standards it implements (such as FA2), its balance, who deployed it and when, how many transactions and tokens it has, and what its own metadata says about it.

Inputs

ContractcontracttextRequired
The contract's address (KT1...).
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

addresstext
The contract's address.
aliastext
The name TzKT knows it by.
balance_teznumber
The tez it holds.
code_hashnumber
A hash of its code: contracts with the same one run the same code.
creator_addresstext
The creator's address.
creator_aliastext
The name TzKT knows the creator by, such as an exchange or a dapp, when it has one.
delegate_addresstext
The baker it delegates to, if any.
delegate_aliastext
That baker's name.
deployed_attext
When it was deployed, ISO 8601.
events_countnumber
How many events it has emitted.
kindtext
TzKT's kind: asset (a token contract), smart_contract or delegator_contract.
last_activity_timetext
When it last changed, ISO 8601.
metadata_descriptiontext
Its description, from its own metadata.
metadata_homepagetext
Its homepage, from its own metadata.
metadata_nametext
Its name, from its own metadata.
metadata_versiontext
Its version, from its own metadata.
networktext
The network read: mainnet or shadownet.
standardslist
The standards it implements, such as fa2 or fa1.2.
tokens_countnumber
How many tokens it has made.
transactions_countnumber
How many transactions it has taken part in.
type_hashnumber
A hash of its interface: contracts with the same one take the same calls.
tzkt_urltext
Its page on TzKT, the Tezos explorer.
Example output
{
  "address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
  "alias": "Tether Token",
  "balance_tez": 0.7812,
  "code_hash": 765038545,
  "creator_address": "tz1YY1LvD6TFH4z74pvxPQXBjAKHE5tB5Q8f",
  "creator_alias": "Florin",
  "delegate_address": null,
  "delegate_alias": null,
  "deployed_at": "2022-06-21T08:24:14Z",
  "events_count": 0,
  "kind": "asset",
  "last_activity_time": "2026-10-23T23:19:31Z",
  "metadata_description": "All Tether tokens are pegged at 1-to-1 with a matching fiat currency and built by a trusted team of developers which operates under tether.to.",
  "metadata_homepage": "https://tether.to/",
  "metadata_name": "Tether Token",
  "metadata_version": "1.0.1",
  "network": "mainnet",
  "standards": [
    "fa2"
  ],
  "tokens_count": 1,
  "transactions_count": 1992208,
  "type_hash": 1928672022,
  "tzkt_url": "https://tzkt.io/KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o"
}

Get token

Get a Tezos token or NFT by its contract and id: its name, symbol, decimals, supply in whole tokens, how many hold it and have moved it, who minted it first, and its pictures.

Inputs

ContractcontracttextRequired
The token's contract address (KT1...). 'Find tokens' gives it.
Token idtoken_idtext
The token's id within its contract, a whole number. Leave empty for 0, the id of an FA1.2 token and of most single token contracts.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

artifact_uritext
For an NFT: the work itself.
balances_countnumber
How many accounts have ever held some.
contract_addresstext
The token's contract.
contract_aliastext
The name TzKT knows the contract by.
decimalsnumber
Its decimal places: amounts are given in whole tokens using them.
descriptiontext
Its description, from its metadata.
display_uritext
For an NFT: the picture to show.
first_minter_addresstext
Who minted it first.
first_timetext
When it first appeared, ISO 8601.
holders_countnumber
How many accounts hold some now.
last_timetext
When it last moved, ISO 8601.
nametext
The token's name, from its metadata.
networktext
The network read: mainnet or shadownet.
standardtext
fa1.2 or fa2.
symboltext
Its symbol, such as USDt.
thumbnail_uritext
Its picture, often an ipfs:// link.
token_idtext
The token's id within its contract (0 for an FA1.2 token).
total_burnednumber
How many were burned, in whole tokens.
total_mintednumber
How many were ever minted, in whole tokens.
total_supplynumber
How many exist, in whole tokens.
total_supply_rawtext
The same, in the token's smallest unit, as text.
transfers_countnumber
How many times it has been moved.
tzkt_urltext
Its page on TzKT, the Tezos explorer.
Example output
{
  "artifact_uri": null,
  "balances_count": 30005,
  "contract_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
  "contract_alias": "Tether Token",
  "decimals": 6,
  "description": null,
  "display_uri": null,
  "first_minter_address": "tz1RZpNZYKtpmQhs8AxKcYVaKEek1kp8YbLZ",
  "first_time": "2022-06-30T13:12:59Z",
  "holders_count": 3318,
  "last_time": "2026-10-23T23:19:31Z",
  "name": "Tether USD",
  "network": "mainnet",
  "standard": "fa2",
  "symbol": "USDt",
  "thumbnail_uri": "ipfs://QmRymVGWEudMfLrbjaEiXxngCRTDgWCsscjQMwizy4ZJjX",
  "token_id": "0",
  "total_burned": 0.0,
  "total_minted": 141000001.0,
  "total_supply": 141000001.0,
  "total_supply_raw": "141000001000000",
  "transfers_count": 1020437,
  "tzkt_url": "https://tzkt.io/KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o/tokens/0"
}

Get XTZ price

Get the price of one tez (XTZ) in US dollars, euros, pounds, yen, yuan, won, bitcoin and ether, now or at a past moment, as TzKT records it with every block.

Inputs

Atatdate and time
A past moment to read the price at. Leave empty for now.

Outputs

btcnumber
One tez in bitcoin.
cnynumber
One tez in Chinese yuan.
ethnumber
One tez in ether.
eurnumber
One tez in euros.
gbpnumber
One tez in British pounds.
jpynumber
One tez in Japanese yen.
krwnumber
One tez in South Korean won.
levelnumber
The block the price was recorded at.
timestamptext
When, ISO 8601.
usdnumber
One tez in US dollars.
Example output
{
  "btc": 3.7524862781894343e-06,
  "cny": 2.0434673139736645,
  "eth": 0.00012816168653767714,
  "eur": 0.2736930127388654,
  "gbp": 0.22907855553451084,
  "jpy": 48.07888478807094,
  "krw": 405.6552719620158,
  "level": 15497379,
  "timestamp": "2026-10-23T11:59:58Z",
  "usd": 0.30634854191257865
}

List account tokens

List the tokens and NFTs an account holds, the most recently changed first, each with its name, symbol and balance in whole tokens.

Inputs

AccountaddresstextRequired
The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
Token standardstandardtext
Only tokens of this standard. Leave empty for both.One of: fa1.2 (FA1.2 (one token per contract)), fa2 (FA2 (several tokens or NFTs per contract)).
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

addresstext
The account read.
countnumber
How many are listed.
more_availabletrue/false
True when the list stopped at the number asked for, so more may exist.
networktext
The network read: mainnet or shadownet.
tokenslist
The tokens it holds, the most recently changed first.
Example output
{
  "address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
  "count": 2,
  "more_available": true,
  "network": "mainnet",
  "tokens": [
    {
      "balance": 5000.0,
      "balance_raw": "500000",
      "contract_address": "KT1MZg99PxMDEENwB4Fi64xkqAVh5d1rv8Z9",
      "contract_alias": "Tezos Pepe",
      "decimals": 2,
      "first_time": "2024-12-11T22:05:35Z",
      "last_change_time": "2024-12-11T22:05:35Z",
      "name": "Tezos Pepe",
      "standard": "fa2",
      "symbol": "PEPE",
      "thumbnail_uri": "https://bafybeigqka2ynrib6ytxku3nvakork5smsxni5xdqro56kd7ecsfos7z7a.ipfs.dweb.link/",
      "token_id": "0",
      "transfers_count": 1,
      "tzkt_url": "https://tzkt.io/KT1MZg99PxMDEENwB4Fi64xkqAVh5d1rv8Z9/tokens/0"
    },
    {
      "balance": 1.0,
      "balance_raw": "1",
      "contract_address": "KT1R3gHb2GqKbUncSkDHGr5sXET5D7Z6ctu9",
      "contract_alias": null,
      "decimals": 0,
      "first_time": "2024-12-11T22:04:55Z",
      "last_change_time": "2024-12-11T22:04:55Z",
      "name": "Wanna join a cult?",
      "standard": "fa2",
      "symbol": "OBJKTCOM",
      "thumbnail_uri": "ipfs://QmZZvWjjmc2s435GVMgofwh64h16TruobTNM4NNn3AKxYx",
      "token_id": "12",
      "transfers_count": 1,
      "tzkt_url": "https://tzkt.io/KT1R3gHb2GqKbUncSkDHGr5sXET5D7Z6ctu9/tokens/12"
    }
  ]
}

List bakers

List the active Tezos bakers, ranked by baking power, delegators or stakers, with each one's stake, how many delegate and stake with it, whether it takes stakers and how much more, and the share of stakers' rewards it keeps.

Inputs

Rank bysort_bytext
How to rank the bakers. Defaults to baking power.One of: baking_power (Baking power), delegators (Most delegators), stakers (Most stakers), external_staked (Most tez staked by others). Default: baking_power.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

bakerslist
The active bakers, ranked.
countnumber
How many are listed.
networktext
The network read: mainnet or shadownet.
sort_bytext
How the list is ranked.
Example output
{
  "bakers": [
    {
      "accepts_stakers": true,
      "active_since": "2018-07-19T21:33:27Z",
      "address": "tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv",
      "alias": "Kraken Baker",
      "baking_power_tez": 62918893.910944,
      "delegators_count": 3866,
      "edge_percent": 10.0,
      "external_delegated_tez": 8669028.776655,
      "external_staked_tez": 53365086.417067,
      "free_staking_capacity_tez": 5994193.454183,
      "own_delegated_tez": 205967.081226,
      "own_staked_tez": 6595475.54125,
      "software_version": "v25.3",
      "stakers_count": 100,
      "staking_limit": 9.0,
      "tzkt_url": "https://tzkt.io/tz1RCFbB9GpALpsZtu6J58sb74dm8qe6XBzv"
    },
    {
      "accepts_stakers": false,
      "active_since": "2019-04-06T18:22:36Z",
      "address": "tz1irJKkXS2DBWkU1NnmFQx1c1L7pbGg4yhk",
      "alias": "Coinbase Baker",
      "baking_power_tez": 43910718.388091,
      "delegators_count": 2810,
      "edge_percent": null,
      "external_delegated_tez": 89891655.636174,
      "external_staked_tez": 0.0,
      "free_staking_capacity_tez": 0.0,
      "own_delegated_tez": 1062740.008895,
      "own_staked_tez": 13592586.506402,
      "software_version": "v25.3",
      "stakers_count": 0,
      "staking_limit": 0.0,
      "tzkt_url": "https://tzkt.io/tz1irJKkXS2DBWkU1NnmFQx1c1L7pbGg4yhk"
    }
  ],
  "count": 2,
  "network": "mainnet",
  "sort_by": "baking_power"
}

List contract entrypoints

List a smart contract's entrypoints (the calls it takes, such as transfer or mint), each with an outline of the fields it expects.

Inputs

ContractcontracttextRequired
The contract's address (KT1...).
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

contracttext
The contract read.
countnumber
How many are listed.
entrypointslist
Its entrypoints.
networktext
The network read: mainnet or shadownet.
Example output
{
  "contract": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
  "count": 2,
  "entrypoints": [
    {
      "name": "add_token",
      "parameter_schema": {
        "schema:object": {
          "token_id:nat": "nat",
          "token_info:map_flat:string:bytes": {
            "string": "bytes"
          }
        }
      },
      "unused": false
    },
    {
      "name": "burn",
      "parameter_schema": {
        "schema:list:object": [
          {
            "owner:address": "address",
            "token_amount:nat": "nat",
            "token_id:nat": "nat"
          }
        ]
      },
      "unused": false
    }
  ],
  "network": "mainnet"
}

List token holders

List the accounts holding a token, the biggest first, with each one's balance in whole tokens and its share of the supply.

Inputs

ContractcontracttextRequired
The token's contract address (KT1...). 'Find tokens' gives it.
Token idtoken_idtext
The token's id within its contract, a whole number. Leave empty for 0, the id of an FA1.2 token and of most single token contracts.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

contract_addresstext
The token's contract.
countnumber
How many are listed.
decimalsnumber
Its decimal places.
holderslist
The holders, the biggest first.
holders_countnumber
How many accounts hold some.
nametext
The token's name.
networktext
The network read: mainnet or shadownet.
symboltext
Its symbol.
token_idtext
The token's id.
total_supplynumber
How many exist, in whole tokens.
Example output
{
  "contract_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
  "count": 2,
  "decimals": 6,
  "holders": [
    {
      "address": "tz1PcFh6tTzBXrV21AEpJhN1k8rcLY5t7t1z",
      "alias": null,
      "balance": 113722091.363774,
      "balance_raw": "113722091363774",
      "last_change_time": "2026-09-03T10:41:10Z",
      "share_percent": 80.654
    },
    {
      "address": "KT1JmfujyCYTw5krfu9bSn7YbLYuz2VbNaje",
      "alias": "Youves v3 Engine Vault (uUSD with USDT)",
      "balance": 13408639.257002,
      "balance_raw": "13408639257002",
      "last_change_time": "2026-05-07T07:57:46Z",
      "share_percent": 9.5097
    }
  ],
  "holders_count": 3318,
  "name": "Tether USD",
  "network": "mainnet",
  "symbol": "USDt",
  "token_id": "0",
  "total_supply": 141000001.0
}

List token transfers

List token and NFT transfers, newest first: of one account (only received or sent if you like), of one token or contract, or both, optionally between two moments. Each comes with the amount in whole tokens, who sent and received it, whether it was a mint or a burn, and its operation hash.

Inputs

Accountaccounttext
Only transfers this account sent or received: its address or .tez name. Leave empty for every account.
Directiondirectiontext
With an account: only what it received, or only what it sent. Leave empty for both.One of: received (Received (it came in)), sent (Sent (it went out)).
Contractcontracttext
Only transfers of tokens of this contract (KT1...). Leave empty for every token.
Token idtoken_idtext
With a contract: only this token of it, such as 0. Leave empty for every token of the contract.
Fromfrom_timedate and time
Only those from this moment on.
Untiluntil_timedate and time
Only those up to this moment.
Orderordertext
Newest or oldest first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

accounttext
The account the list was narrowed to, if any.
countnumber
How many are listed.
more_availabletrue/false
True when the list stopped at the number asked for, so more may exist.
networktext
The network read: mainnet or shadownet.
transferslist
The transfers.
Example output
{
  "account": null,
  "count": 2,
  "more_available": true,
  "network": "mainnet",
  "transfers": [
    {
      "amount": 1542.728868,
      "amount_raw": "1542728868",
      "contract_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
      "contract_alias": "Tether Token",
      "decimals": 6,
      "direction": null,
      "from_address": "tz1ftMpsP4KdtJdK6j1owQshrv8co6cgpP1C",
      "from_alias": null,
      "id": 2996519816921089,
      "level": 15504011,
      "name": "Tether USD",
      "standard": "fa2",
      "symbol": "USDt",
      "timestamp": "2026-10-23T23:19:31Z",
      "to_address": "tz2FjD9wYiGzz97aJv6qJvQyAsoULhaTaVu9",
      "to_alias": null,
      "token_id": "0",
      "transaction_hash": "onq9ffwQAWzwzBCeCkyVXiwcfwLeJjknqd9sZyTf8fwiTaF2pzS",
      "transfer_kind": "transfer",
      "tzkt_url": "https://tzkt.io/onq9ffwQAWzwzBCeCkyVXiwcfwLeJjknqd9sZyTf8fwiTaF2pzS"
    },
    {
      "amount": 310.542992,
      "amount_raw": "310542992",
      "contract_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
      "contract_alias": "Tether Token",
      "decimals": 6,
      "direction": null,
      "from_address": "tz1dgVeTDwo5G9w9Ky6AUJGurTvDb1NNE5UK",
      "from_alias": "Johnny Sins",
      "id": 2996517627494401,
      "level": 15504004,
      "name": "Tether USD",
      "standard": "fa2",
      "symbol": "USDt",
      "timestamp": "2026-10-23T23:18:49Z",
      "to_address": "tz1dgVeTDwo5G9w9Ky6AUJGurTvDb1NNE5UK",
      "to_alias": "Johnny Sins",
      "token_id": "0",
      "transaction_hash": "oofA6LMcoPZEkTNrRjkhmXFrmCy5RnkBri5amVNM3ykeFE9hCoe",
      "transfer_kind": "transfer",
      "tzkt_url": "https://tzkt.io/oofA6LMcoPZEkTNrRjkhmXFrmCy5RnkBri5amVNM3ykeFE9hCoe"
    }
  ]
}

List transactions

List Tezos transactions, newest first: of one account or the whole network, optionally only those it received or sent, only those with one other account, only transfers of tez or only contract calls (to one entrypoint), only one outcome, from an amount up, or between two moments. Each comes with its amount in tez, fees, entrypoint and what it was worth.

Inputs

Accountaccounttext
Only transactions this account sent or received: its address or .tez name. Leave empty for the whole network.
Directiondirectiontext
With an account: only what it received, or only what it sent. Leave empty for both.One of: received (Received (it came in)), sent (Sent (it went out)).
Other accountcounterpartytext
With an account: only transactions between it and this address or .tez name.
Transfers or callstransaction_kindtext
Only plain transfers of tez, or only smart contract calls. Defaults to both.One of: all (Transfers and contract calls), transfers (Transfers of tez only), calls (Contract calls only). Default: all.
Entrypointentrypointtext
Only calls to this contract entrypoint, such as transfer or mint. 'List contract entrypoints' names them.
Outcomestatustext
Only transactions that ended this way. Leave empty for all.One of: applied (Applied (it went through)), failed, backtracked (Backtracked (undone by a later failure in its group)), skipped (Skipped (not run after an earlier failure)).
At least (tez)min_amountnumber
Only transactions sending at least this many tez, such as 100. Leave empty for any amount.At least 0.
Fromfrom_timedate and time
Only those from this moment on.
Untiluntil_timedate and time
Only those up to this moment.
Orderordertext
Newest or oldest first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100. Default: 25.
Value incurrencytext
The currency to give prices and values in. Defaults to US dollars.One of: usd (US dollar (USD)), eur (Euro (EUR)), gbp (British pound (GBP)), jpy (Japanese yen (JPY)), cny (Chinese yuan (CNY)), krw (South Korean won (KRW)), btc (Bitcoin (BTC)), eth (Ether (ETH)). Default: usd.
Networknetworktext
Which Tezos network to read. Defaults to Mainnet.One of: mainnet, shadownet (Shadownet (testnet)). Default: mainnet.

Outputs

accounttext
The account the list was narrowed to, if any.
countnumber
How many are listed.
currencytext
The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
more_availabletrue/false
True when the list stopped at the number asked for, so more may exist.
networktext
The network read: mainnet or shadownet.
transactionslist
The transactions.
Example output
{
  "account": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
  "count": 2,
  "currency": "usd",
  "more_available": true,
  "network": "mainnet",
  "transactions": [
    {
      "amount_mutez": 0,
      "amount_tez": 0.0,
      "baker_fee_tez": 0.000897,
      "direction": "received",
      "entrypoint": "transfer",
      "errors": [],
      "fee_tez": 0.000897,
      "hash": "onq9ffwQAWzwzBCeCkyVXiwcfwLeJjknqd9sZyTf8fwiTaF2pzS",
      "id": 2996519816921088,
      "initiator_address": null,
      "is_internal": false,
      "level": 15504011,
      "parameter": [
        {
          "from_": "tz1ftMpsP4KdtJdK6j1owQshrv8co6cgpP1C",
          "txs": [
            {
              "amount": "1542728868",
              "to_": "tz2FjD9wYiGzz97aJv6qJvQyAsoULhaTaVu9",
              "token_id": "0"
            }
          ]
        }
      ],
      "price": 0.3001081755417106,
      "sender_address": "tz1ftMpsP4KdtJdK6j1owQshrv8co6cgpP1C",
      "sender_alias": null,
      "status": "applied",
      "storage_fee_tez": 0.0,
      "succeeded": true,
      "target_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
      "target_alias": "Tether Token",
      "timestamp": "2026-10-23T23:19:31Z",
      "tzkt_url": "https://tzkt.io/onq9ffwQAWzwzBCeCkyVXiwcfwLeJjknqd9sZyTf8fwiTaF2pzS",
      "value": 0.0
    },
    {
      "amount_mutez": 0,
      "amount_tez": 0.0,
      "baker_fee_tez": 0.0,
      "direction": "received",
      "entrypoint": "transfer",
      "errors": [],
      "fee_tez": 0.0,
      "hash": "oofA6LMcoPZEkTNrRjkhmXFrmCy5RnkBri5amVNM3ykeFE9hCoe",
      "id": 2996517627494400,
      "initiator_address": null,
      "is_internal": false,
      "level": 15504004,
      "parameter": [
        {
          "from_": "tz1dgVeTDwo5G9w9Ky6AUJGurTvDb1NNE5UK",
          "txs": [
            {
              "amount": "310542992",
              "to_": "tz1dgVeTDwo5G9w9Ky6AUJGurTvDb1NNE5UK",
              "token_id": "0"
            }
          ]
        }
      ],
      "price": 0.3001081755417106,
      "sender_address": "tz1dgVeTDwo5G9w9Ky6AUJGurTvDb1NNE5UK",
      "sender_alias": "Johnny Sins",
      "status": "applied",
      "storage_fee_tez": 0.0,
      "succeeded": true,
      "target_address": "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
      "target_alias": "Tether Token",
      "timestamp": "2026-10-23T23:18:49Z",
      "tzkt_url": "https://tzkt.io/oofA6LMcoPZEkTNrRjkhmXFrmCy5RnkBri5amVNM3ykeFE9hCoe",
      "value": 0.0
    }
  ]
}

Look up a Tezos domain

Look up a Tezos Domains name, such as baking-bad.tez: the address it points to, who owns it, when it expires and what its owner attached to it. 'Found' is false for a name no one has registered.

Inputs

DomaindomaintextRequired
The name, ending in .tez.

Outputs

addresstext
The address it points to.
address_aliastext
The name TzKT knows that address by.
dataobject
What its owner attached to it, such as a website or a Twitter handle.
expiredtrue/false
True when it has expired.
expires_attext
When it expires unless renewed, ISO 8601.
foundtrue/false
False when no one has registered the name.
is_primarytrue/false
True when it is the address's primary name: the one wallets show for it.
nametext
The name, such as baking-bad.tez.
owner_addresstext
Who owns the name.
owner_aliastext
The name TzKT knows the owner by.
registered_attext
When it was registered, ISO 8601.
tezos_domains_urltext
Its page on Tezos Domains.
updated_attext
When it last changed, ISO 8601.
Example output
{
  "address": "tz1TPXFXctCyJ6ZLBo2kbb9EPkEQdcVUN1rB",
  "address_alias": null,
  "data": {
    "gravatar:hash": "f67d1a519759e7904795574a51672ed2",
    "twitter:handle": "TezosBakingBad",
    "web:content_url": "https://baking-bad.org",
    "web:governance_profile_url": "https://talk.tezos.domains/t/how-to-become-a-delegate/34/10?u=bakingbad"
  },
  "expired": false,
  "expires_at": "2028-04-28T00:00:00Z",
  "found": true,
  "is_primary": true,
  "name": "baking-bad.tez",
  "owner_address": "tz1TPXFXctCyJ6ZLBo2kbb9EPkEQdcVUN1rB",
  "owner_alias": null,
  "registered_at": "2021-04-07T15:14:51Z",
  "tezos_domains_url": "https://app.tezos.domains/domain/baking-bad.tez",
  "updated_at": "2023-10-11T14:40:59Z"
}

On this page