Tezos · Schema

Contract

TezosBlockchainTzKTBaking BadCryptocurrencySmart ContractsNFTTokensDelegationStakingGovernanceFA1.2FA2WebSocket

Properties

Name	Type	Description
id	integer	Internal TzKT id. [sortable]
type	string	Type of the account, `contract` - smart contract programmable account.
address	string	Public key hash of the contract
kind	string	Kind of the contract (`delegator_contract` or `smart_contract`), where `delegator_contract` - manager.tz smart contract for delegation purpose only.
tzips	array	List of implemented standards (TZIPs).
alias	string	Name of the project behind the contract or contract description.
balance	integer	Contract balance (micro tez). [sortable]
creator	object	Information about the account, which has deployed the contract to the blockchain. Click on the field to expand more details.
delegate	object	Information about the current delegate of the contract. `null` if it's not delegated. Click on the field to expand more details.
delegationLevel	integer	Block height of latest delegation. `null` if it's not delegated.
delegationTime	string	Block datetime of latest delegation (ISO 8601, e.g. `2020-02-20T02:40:57Z`). `null` if it's not delegated.
numContracts	integer	Number of contracts, created (originated) and/or managed by the contract.
tokensCount	integer	Number of tokens minted in the contract.
activeTokensCount	integer	Number of account tokens with non-zero balances.
tokenBalancesCount	integer	Number of tokens the account ever had.
tokenTransfersCount	integer	Number of token transfers from/to the account.
ticketsCount	integer	Number of tickets minted in the contract.
activeTicketsCount	integer	Number of tickets the account owns.
ticketBalancesCount	integer	Number of tickets the account ever owned.
ticketTransfersCount	integer	Number of ticket transfers from/to the account.
numDelegations	integer	Number of delegation operations of the contract.
numOriginations	integer	Number of origination (deployment / contract creation) operations, related the contract.
numTransactions	integer	Number of transaction (transfer) operations, related to the contract. [sortable]
numReveals	integer	Number of reveal (is used to reveal the public key associated with an account) operations of the contract.
numMigrations	integer	Number of migration (result of the context (database) migration during a protocol update) operations. related to the contract (synthetic type).
transferTicketCount	integer	Number of transfer ticket operations related to the contract.
increasePaidStorageCount	integer	Number of `increase_paid_storage` operations related to the contract.
eventsCount	integer	Number of events produced by the contract.
firstActivity	integer	Block height of the contract creation. [sortable]
firstActivityTime	string	Block datetime of the contract creation (ISO 8601, e.g. `2020-02-20T02:40:57Z`).
lastActivity	integer	Height of the block in which the account state was changed last time. [sortable]
lastActivityTime	string	Datetime of the block in which the account state was changed last time (ISO 8601, e.g. `2020-02-20T02:40:57Z`).
typeHash	integer	32-bit hash of the contract parameter and storage types. This field can be used for searching similar contracts (which have the same interface).
codeHash	integer	32-bit hash of the contract code. This field can be used for searching same contracts (which have the same script).
metadata	object	TZIP-16 metadata.
extras	object	Off-chain extras.
storage	object	Contract storage value. Omitted by default. Use `?includeStorage=true` to include it into response.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Contract",
  "allOf": [
    {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "id": {
          "type": "integer",
          "description": "Internal TzKT id.  \n**[sortable]**",
          "format": "int32"
        },
        "type": {
          "type": "string",
          "description": "Type of the account, `contract` - smart contract programmable account."
        },
        "address": {
          "type": "string",
          "description": "Public key hash of the contract"
        },
        "kind": {
          "type": "string",
          "description": "Kind of the contract (`delegator_contract` or `smart_contract`),\nwhere `delegator_contract` - manager.tz smart contract for delegation purpose only."
        },
        "tzips": {
          "type": "array",
          "description": "List of implemented standards (TZIPs).",
          "nullable": true,
          "items": {
            "type": "string"
          }
        },
        "alias": {
          "type": "string",
          "description": "Name of the project behind the contract or contract description.",
          "nullable": true
        },
        "balance": {
          "type": "integer",
          "description": "Contract balance (micro tez).  \n**[sortable]**",
          "format": "int64"
        },
        "creator": {
          "description": "Information about the account, which has deployed the contract to the blockchain.  \nClick on the field to expand more details.",
          "oneOf": [
            {
              "$ref": "#/components/schemas/Alias"
            }
          ]
        },
        "delegate": {
          "description": "Information about the current delegate of the contract. `null` if it's not delegated.  \nClick on the field to expand more details.",
          "nullable": true,
          "oneOf": [
            {
              "$ref": "#/components/schemas/DelegateInfo"
            }
          ]
        },
        "delegationLevel": {
          "type": "integer",
          "description": "Block height of latest delegation. `null` if it's not delegated.",
          "format": "int32",
          "nullable": true
        },
        "delegationTime": {
          "type": "string",
          "description": "Block datetime of latest delegation (ISO 8601, e.g. `2020-02-20T02:40:57Z`). `null` if it's not delegated.",
          "format": "date-time",
          "nullable": true
        },
        "numContracts": {
          "type": "integer",
          "description": "Number of contracts, created (originated) and/or managed by the contract.",
          "format": "int32"
        },
        "tokensCount": {
          "type": "integer",
          "description": "Number of tokens minted in the contract.",
          "format": "int32"
        },
        "activeTokensCount": {
          "type": "integer",
          "description": "Number of account tokens with non-zero balances.",
          "format": "int32"
        },
        "tokenBalancesCount": {
          "type": "integer",
          "description": "Number of tokens the account ever had.",
          "format": "int32"
        },
        "tokenTransfersCount": {
          "type": "integer",
          "description": "Number of token transfers from/to the account.",
          "format": "int32"
        },
        "ticketsCount": {
          "type": "integer",
          "description": "Number of tickets minted in the contract.",
          "format": "int32"
        },
        "activeTicketsCount": {
          "type": "integer",
          "description": "Number of tickets the account owns.",
          "format": "int32"
        },
        "ticketBalancesCount": {
          "type": "integer",
          "description": "Number of tickets the account ever owned.",
          "format": "int32"
        },
        "ticketTransfersCount": {
          "type": "integer",
          "description": "Number of ticket transfers from/to the account.",
          "format": "int32"
        },
        "numDelegations": {
          "type": "integer",
          "description": "Number of delegation operations of the contract.",
          "format": "int32"
        },
        "numOriginations": {
          "type": "integer",
          "description": "Number of origination (deployment / contract creation) operations, related the contract.",
          "format": "int32"
        },
        "numTransactions": {
          "type": "integer",
          "description": "Number of transaction (transfer) operations, related to the contract.  \n**[sortable]**",
          "format": "int32"
        },
        "numReveals": {
          "type": "integer",
          "description": "Number of reveal (is used to reveal the public key associated with an account) operations of the contract.",
          "format": "int32"
        },
        "numMigrations": {
          "type": "integer",
          "description": "Number of migration (result of the context (database) migration during a protocol update) operations.\nrelated to the contract (synthetic type).",
          "format": "int32"
        },
        "transferTicketCount": {
          "type": "integer",
          "description": "Number of transfer ticket operations related to the contract.",
          "format": "int32"
        },
        "increasePaidStorageCount": {
          "type": "integer",
          "description": "Number of `increase_paid_storage` operations related to the contract.",
          "format": "int32"
        },
        "eventsCount": {
          "type": "integer",
          "description": "Number of events produced by the contract.",
          "format": "int32"
        },
        "firstActivity": {
          "type": "integer",
          "description": "Block height of the contract creation.  \n**[sortable]**",
          "format": "int32"
        },
        "firstActivityTime": {
          "type": "string",
          "description": "Block datetime of the contract creation (ISO 8601, e.g. `2020-02-20T02:40:57Z`).",
          "format": "date-time"
        },
        "lastActivity": {
          "type": "integer",
          "description": "Height of the block in which the account state was changed last time.  \n**[sortable]**",
          "format": "int32"
        },
        "lastActivityTime": {
          "type": "string",
          "description": "Datetime of the block in which the account state was changed last time (ISO 8601, e.g. `2020-02-20T02:40:57Z`).",
          "format": "date-time"
        },
        "typeHash": {
          "type": "integer",
          "description": "32-bit hash of the contract parameter and storage types.\nThis field can be used for searching similar contracts (which have the same interface).",
          "format": "int32"
        },
        "codeHash": {
          "type": "integer",
          "description": "32-bit hash of the contract code.\nThis field can be used for searching same contracts (which have the same script).",
          "format": "int32"
        },
        "metadata": {
          "description": "TZIP-16 metadata.",
          "nullable": true
        },
        "extras": {
          "description": "Off-chain extras.",
          "nullable": true
        },
        "storage": {
          "description": "Contract storage value. Omitted by default. Use `?includeStorage=true` to include it into response.",
          "nullable": true
        }
      }
    }
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/contract"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.