# TzKT

> 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).

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/tzkt

## Actions

### 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**

- Address (`address`, text, required): The address (tz1..., KT1...).

**Outputs**

- `address` (text): The address read.
- `count` (number): How many are listed.
- `domains` (list): The names pointing to it: the primary one first, expired ones last.
- `primary_domain` (text): Its primary name, the one wallets show for it, when it has one.

**Example output**

```json
{
  "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**

- Search (`search`, text): 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 standard (`standard`, text): 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 results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `count` (number): How many are listed.
- `more_available` (true/false): True when the list stopped at the number asked for, so more may exist.
- `network` (text): The network read: mainnet or shadownet.
- `search` (text): The text searched for.
- `tokens` (list): The tokens found, the most held first. Anyone can name a token anything, so check the contract.

**Example output**

```json
{
  "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**

- Account (`address`, text, required): The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
- Value in (`currency`, text): 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`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `address` (text): The account's address.
- `alias` (text): The name TzKT knows it by, when it has one.
- `baker_active` (true/false): For a baker: whether it is baking now.
- `baking_power_tez` (number): For a baker: its baking power in tez.
- `balance_mutez` (number): The same balance in mutez (1 tez is 1,000,000 mutez).
- `balance_tez` (number): Everything it holds in tez: spendable, staked and being unstaked.
- `contract_kind` (text): For a smart contract: TzKT's kind, such as asset (a token contract), smart_contract or delegator_contract.
- `contracts_count` (number): How many smart contracts it has deployed.
- `currency` (text): The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
- `delegate_address` (text): The baker it delegates to, if any.
- `delegate_alias` (text): That baker's name.
- `delegated_since` (text): When it last chose its baker, ISO 8601.
- `delegators_count` (number): For a baker: how many delegate to it.
- `external_delegated_tez` (number): For a baker: tez others delegated to it.
- `external_staked_tez` (number): For a baker: tez others staked with it.
- `first_activity_time` (text): When it was first used, ISO 8601.
- `is_baker` (true/false): True for a baker (a registered delegate).
- `last_activity_time` (text): When it last changed, ISO 8601.
- `network` (text): The network read: mainnet or shadownet.
- `price` (number): The price of one tez in that currency now. Empty on a test network.
- `revealed` (true/false): Whether its public key is on the chain, which an account needs before it can send anything.
- `spendable_tez` (number): The tez it can spend or send now.
- `staked_tez` (number): Its tez staked with its baker (or, for a baker, its own stake).
- `stakers_count` (number): For a baker: how many stake with it.
- `tokens_held_count` (number): How many different tokens and NFTs it holds.
- `transactions_count` (number): How many transactions it has taken part in.
- `type` (text): 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_url` (text): Its page on TzKT, the Tezos explorer.
- `unstaked_tez` (number): Tez it unstaked that are still frozen, waiting to become spendable.
- `value` (number): What its whole balance is worth now in that currency. Empty on a test network.

**Example output**

```json
{
  "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**

- Account (`address`, text, required): The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
- Value in (`currency`, text): 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`.
- Order (`order`, text): Newest or oldest first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `address` (text): The account read.
- `count` (number): How many are listed.
- `currency` (text): The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
- `more_available` (true/false): True when the list stopped at the number asked for, so more may exist.
- `network` (text): The network read: mainnet or shadownet.
- `points` (list): The balance each time it changed.

**Example output**

```json
{
  "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**

- Account (`address`, text, required): The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
- At (`at`, date and time, required): The moment to read the balance at.
- Value in (`currency`, text): 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`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `address` (text): The account read.
- `at` (text): The moment asked about, ISO 8601 in UTC.
- `balance_mutez` (number): The same balance in mutez.
- `balance_tez` (number): Its balance then, in tez. For an account staking with a baker this leaves its staked tez out.
- `currency` (text): The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
- `network` (text): The network read: mainnet or shadownet.
- `price` (number): The price of one tez in that currency at the time. Empty on a test network.
- `price_time` (text): When that price was recorded, ISO 8601.
- `value` (number): The tez amount times that price: what it was worth then. Empty on a test network.

**Example output**

```json
{
  "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**

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

**Outputs**

- `attestation_committee` (number): The size of the committee.
- `attestation_power` (number): How much of the committee attested it.
- `block_round` (number): The round it was made in (0 is on time).
- `cycle` (number): The cycle it is in.
- `fees_tez` (number): The fees of every operation in it, in tez.
- `hash` (text): The block's hash.
- `is_latest` (true/false): True when it is the newest block.
- `latest_level` (number): The newest block's level when it was read.
- `level` (number): The block's level (its height in the chain).
- `network` (text): The network read: mainnet or shadownet.
- `payload_round` (number): The round its contents were proposed in.
- `producer_address` (text): The producer's address.
- `producer_alias` (text): The name TzKT knows the producer by, such as an exchange or a dapp, when it has one.
- `proposer_address` (text): The proposer's address.
- `proposer_alias` (text): The name TzKT knows the proposer by, such as an exchange or a dapp, when it has one.
- `protocol_code` (number): Which protocol upgrade it was made under, counted from the start.
- `rewards_tez` (number): The rewards paid for it, in tez.
- `timestamp` (text): When it was made, ISO 8601.
- `transactions_count` (number): How many transactions it holds.
- `tzkt_url` (text): Its page on TzKT, the Tezos explorer.

**Example output**

```json
{
  "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**

- Contract (`contract`, text, required): The contract's address (KT1...).
- Field (`path`, text): 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 of (`at`, date and time): Read it as it was at this moment. Leave empty for now.
- As of block (`level`, number): Instead of a moment: read it as it was at this block level. At least 1.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `contract` (text): The contract read.
- `level` (number): The block it was read at; empty for now.
- `network` (text): The network read: mainnet or shadownet.
- `path` (text): The part of the storage read; empty for all of it.
- `storage` (object): The storage as JSON. A big map shows as its number, which TzKT's big map pages take.

**Example output**

```json
{
  "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**

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

**Outputs**

- `attestation_reward_per_block_tez` (number): The rewards for attesting one block, shared by its attesters, in tez.
- `block_bonus_tez` (number): The bonus for making a block, in tez.
- `block_reward_tez` (number): The reward for proposing a block, in tez.
- `end_time` (text): When it ends, ISO 8601 (expected, for one under way).
- `first_level` (number): Its first block.
- `index` (number): The cycle's number.
- `is_current` (true/false): True for the cycle under way.
- `last_level` (number): Its last block.
- `network` (text): The network read: mainnet or shadownet.
- `progress_percent` (number): How far through it the chain is, 0 to 100.
- `snapshot_level` (number): The block whose stakes decided who bakes in it.
- `start_time` (text): When it starts, ISO 8601.
- `total_bakers` (number): How many bakers take part.
- `total_baking_power_tez` (number): Their baking power together, in tez.

**Example output**

```json
{
  "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**

- On (`date`, date): A past day, to read the figures at its end. Leave empty for now.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `bakers_count` (number): Active bakers.
- `circulating_supply_tez` (number): Tez that can move (not locked), in tez.
- `date` (text): The day read, for a past day. Empty for now.
- `delegators_count` (number): Accounts delegating to a baker.
- `level` (number): The block the figures are from.
- `network` (text): The network read: mainnet or shadownet.
- `sent_to_null_address_tez` (number): Tez sent to the null address, which no one can spend, in tez.
- `staked_percent` (number): Staked tez as a share of circulating tez.
- `stakers_count` (number): Accounts staking with a baker.
- `timestamp` (text): That block's time, ISO 8601.
- `total_baking_power_tez` (number): All bakers' baking power, in tez.
- `total_burned_tez` (number): Tez burned for fees and storage, in tez.
- `total_created_tez` (number): Tez created since the start (rewards), in tez.
- `total_delegated_tez` (number): Tez delegated to bakers, in tez.
- `total_frozen_tez` (number): Tez frozen as stake or deposits, in tez.
- `total_staked_tez` (number): Tez staked by bakers and their stakers, in tez.
- `total_supply_tez` (number): All tez there are, in tez.

**Example output**

```json
{
  "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 hash (`operation_hash`, text, required): The operation's hash: 51 characters starting with o, as a wallet or TzKT shows it. A TzKT link works too.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `amount_tez` (number): The tez its transactions moved, added up.
- `block` (text): The block's hash.
- `count` (number): How many parts it has, those contracts made included.
- `fee_tez` (number): Every fee paid for it, in tez.
- `hash` (text): The operation hash.
- `level` (number): The block it is in.
- `network` (text): The network read: mainnet or shadownet.
- `operations` (list): Each part, in order.
- `sender_address` (text): The sender's address.
- `sender_alias` (text): The name TzKT knows the sender by, such as an exchange or a dapp, when it has one.
- `status` (text): How it ended: applied when every part went through, failed when a part failed (undoing the rest).
- `succeeded` (true/false): True when every part was applied.
- `timestamp` (text): When, ISO 8601.
- `tzkt_url` (text): Its page on TzKT, the Tezos explorer.

**Example output**

```json
{
  "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**

- Contract (`contract`, text, required): The contract's address (KT1...).
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `address` (text): The contract's address.
- `alias` (text): The name TzKT knows it by.
- `balance_tez` (number): The tez it holds.
- `code_hash` (number): A hash of its code: contracts with the same one run the same code.
- `creator_address` (text): The creator's address.
- `creator_alias` (text): The name TzKT knows the creator by, such as an exchange or a dapp, when it has one.
- `delegate_address` (text): The baker it delegates to, if any.
- `delegate_alias` (text): That baker's name.
- `deployed_at` (text): When it was deployed, ISO 8601.
- `events_count` (number): How many events it has emitted.
- `kind` (text): TzKT's kind: asset (a token contract), smart_contract or delegator_contract.
- `last_activity_time` (text): When it last changed, ISO 8601.
- `metadata_description` (text): Its description, from its own metadata.
- `metadata_homepage` (text): Its homepage, from its own metadata.
- `metadata_name` (text): Its name, from its own metadata.
- `metadata_version` (text): Its version, from its own metadata.
- `network` (text): The network read: mainnet or shadownet.
- `standards` (list): The standards it implements, such as fa2 or fa1.2.
- `tokens_count` (number): How many tokens it has made.
- `transactions_count` (number): How many transactions it has taken part in.
- `type_hash` (number): A hash of its interface: contracts with the same one take the same calls.
- `tzkt_url` (text): Its page on TzKT, the Tezos explorer.

**Example output**

```json
{
  "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**

- Contract (`contract`, text, required): The token's contract address (KT1...). 'Find tokens' gives it.
- Token id (`token_id`, text): 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.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `artifact_uri` (text): For an NFT: the work itself.
- `balances_count` (number): How many accounts have ever held some.
- `contract_address` (text): The token's contract.
- `contract_alias` (text): The name TzKT knows the contract by.
- `decimals` (number): Its decimal places: amounts are given in whole tokens using them.
- `description` (text): Its description, from its metadata.
- `display_uri` (text): For an NFT: the picture to show.
- `first_minter_address` (text): Who minted it first.
- `first_time` (text): When it first appeared, ISO 8601.
- `holders_count` (number): How many accounts hold some now.
- `last_time` (text): When it last moved, ISO 8601.
- `name` (text): The token's name, from its metadata.
- `network` (text): The network read: mainnet or shadownet.
- `standard` (text): fa1.2 or fa2.
- `symbol` (text): Its symbol, such as USDt.
- `thumbnail_uri` (text): Its picture, often an ipfs:// link.
- `token_id` (text): The token's id within its contract (0 for an FA1.2 token).
- `total_burned` (number): How many were burned, in whole tokens.
- `total_minted` (number): How many were ever minted, in whole tokens.
- `total_supply` (number): How many exist, in whole tokens.
- `total_supply_raw` (text): The same, in the token's smallest unit, as text.
- `transfers_count` (number): How many times it has been moved.
- `tzkt_url` (text): Its page on TzKT, the Tezos explorer.

**Example output**

```json
{
  "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**

- At (`at`, date and time): A past moment to read the price at. Leave empty for now.

**Outputs**

- `btc` (number): One tez in bitcoin.
- `cny` (number): One tez in Chinese yuan.
- `eth` (number): One tez in ether.
- `eur` (number): One tez in euros.
- `gbp` (number): One tez in British pounds.
- `jpy` (number): One tez in Japanese yen.
- `krw` (number): One tez in South Korean won.
- `level` (number): The block the price was recorded at.
- `timestamp` (text): When, ISO 8601.
- `usd` (number): One tez in US dollars.

**Example output**

```json
{
  "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**

- Account (`address`, text, required): The account's address (tz1..., KT1...) or its .tez name, such as baking-bad.tez. A TzKT link works too.
- Token standard (`standard`, text): 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 results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `address` (text): The account read.
- `count` (number): How many are listed.
- `more_available` (true/false): True when the list stopped at the number asked for, so more may exist.
- `network` (text): The network read: mainnet or shadownet.
- `tokens` (list): The tokens it holds, the most recently changed first.

**Example output**

```json
{
  "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 by (`sort_by`, text): 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 results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `bakers` (list): The active bakers, ranked.
- `count` (number): How many are listed.
- `network` (text): The network read: mainnet or shadownet.
- `sort_by` (text): How the list is ranked.

**Example output**

```json
{
  "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**

- Contract (`contract`, text, required): The contract's address (KT1...).
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `contract` (text): The contract read.
- `count` (number): How many are listed.
- `entrypoints` (list): Its entrypoints.
- `network` (text): The network read: mainnet or shadownet.

**Example output**

```json
{
  "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**

- Contract (`contract`, text, required): The token's contract address (KT1...). 'Find tokens' gives it.
- Token id (`token_id`, text): 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 results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `contract_address` (text): The token's contract.
- `count` (number): How many are listed.
- `decimals` (number): Its decimal places.
- `holders` (list): The holders, the biggest first.
- `holders_count` (number): How many accounts hold some.
- `name` (text): The token's name.
- `network` (text): The network read: mainnet or shadownet.
- `symbol` (text): Its symbol.
- `token_id` (text): The token's id.
- `total_supply` (number): How many exist, in whole tokens.

**Example output**

```json
{
  "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**

- Account (`account`, text): Only transfers this account sent or received: its address or .tez name. Leave empty for every account.
- Direction (`direction`, text): 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)).
- Contract (`contract`, text): Only transfers of tokens of this contract (KT1...). Leave empty for every token.
- Token id (`token_id`, text): With a contract: only this token of it, such as 0. Leave empty for every token of the contract.
- From (`from_time`, date and time): Only those from this moment on.
- Until (`until_time`, date and time): Only those up to this moment.
- Order (`order`, text): Newest or oldest first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `account` (text): The account the list was narrowed to, if any.
- `count` (number): How many are listed.
- `more_available` (true/false): True when the list stopped at the number asked for, so more may exist.
- `network` (text): The network read: mainnet or shadownet.
- `transfers` (list): The transfers.

**Example output**

```json
{
  "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**

- Account (`account`, text): Only transactions this account sent or received: its address or .tez name. Leave empty for the whole network.
- Direction (`direction`, text): 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 account (`counterparty`, text): With an account: only transactions between it and this address or .tez name.
- Transfers or calls (`transaction_kind`, text): 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`.
- Entrypoint (`entrypoint`, text): Only calls to this contract entrypoint, such as transfer or mint. 'List contract entrypoints' names them.
- Outcome (`status`, text): 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_amount`, number): Only transactions sending at least this many tez, such as 100. Leave empty for any amount. At least 0.
- From (`from_time`, date and time): Only those from this moment on.
- Until (`until_time`, date and time): Only those up to this moment.
- Order (`order`, text): Newest or oldest first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Value in (`currency`, text): 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`.
- Network (`network`, text): Which Tezos network to read. Defaults to Mainnet. One of: `mainnet`, `shadownet` (Shadownet (testnet)). Default: `mainnet`.

**Outputs**

- `account` (text): The account the list was narrowed to, if any.
- `count` (number): How many are listed.
- `currency` (text): The currency the price and value are in: usd, eur, gbp, jpy, cny, krw, btc or eth.
- `more_available` (true/false): True when the list stopped at the number asked for, so more may exist.
- `network` (text): The network read: mainnet or shadownet.
- `transactions` (list): The transactions.

**Example output**

```json
{
  "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**

- Domain (`domain`, text, required): The name, ending in .tez.

**Outputs**

- `address` (text): The address it points to.
- `address_alias` (text): The name TzKT knows that address by.
- `data` (object): What its owner attached to it, such as a website or a Twitter handle.
- `expired` (true/false): True when it has expired.
- `expires_at` (text): When it expires unless renewed, ISO 8601.
- `found` (true/false): False when no one has registered the name.
- `is_primary` (true/false): True when it is the address's primary name: the one wallets show for it.
- `name` (text): The name, such as baking-bad.tez.
- `owner_address` (text): Who owns the name.
- `owner_alias` (text): The name TzKT knows the owner by.
- `registered_at` (text): When it was registered, ISO 8601.
- `tezos_domains_url` (text): Its page on Tezos Domains.
- `updated_at` (text): When it last changed, ISO 8601.

**Example output**

```json
{
  "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"
}
```
