Contracts

Get contracts

Returns a list of contract accounts.

GEThttps://xtz-index.nownodes.io/v1/contracts

Query parameters

Response

200

Body

application/json

type*string

idinteger (int32)

Internal TzKT id.
[sortable]

typenullable string

Type of the account, contract - smart contract programmable account.

addressnullable string

Public key hash of the contract

kindnullable string

Kind of the contract (delegator_contract or smart_contract), where delegator_contract - manager.tz smart contract for delegation purpose only.

tzipsnullable array of string

List of implemented standards (TZIPs).

aliasnullable string

Name of the project behind the contract or contract description.

balanceinteger (int64)

Contract balance (micro tez).
[sortable]

creatornullable one of

Information about the account, which has deployed the contract to the blockchain.
Click on the field to expand more details.

CreatorInfo (object)

managernullable one of

Information about the account, which was marked as a manager when contract was deployed to the blockchain.
Click on the field to expand more details.

ManagerInfo (object)

delegatenullable one of

Information about the current delegate of the contract. null if it's not delegated.
Click on the field to expand more details.

DelegateInfo (object)

delegationLevelnullable integer (int32)

Block height of latest delegation. null if it's not delegated.

delegationTimenullable string (date-time)

Block datetime of latest delegation (ISO 8601, e.g. 2020-02-20T02:40:57Z). null if it's not delegated.

numContractsinteger (int32)

Number of contracts, created (originated) and/or managed by the contract.

tokensCountinteger (int32)

Number of tokens minted in the contract.

activeTokensCountinteger (int32)

Number of account tokens with non-zero balances.

tokenBalancesCountinteger (int32)

Number of tokens the account ever had.

tokenTransfersCountinteger (int32)

Number of token transfers from/to the account.

ticketsCountinteger (int32)

Number of tickets minted in the contract.

activeTicketsCountinteger (int32)

Number of tickets the account owns.

ticketBalancesCountinteger (int32)

Number of tickets the account ever owned.

ticketTransfersCountinteger (int32)

Number of ticket transfers from/to the account.

numDelegationsinteger (int32)

Number of delegation operations of the contract.

numOriginationsinteger (int32)

Number of origination (deployment / contract creation) operations, related the contract.

numTransactionsinteger (int32)

Number of transaction (transfer) operations, related to the contract.
[sortable]

numRevealsinteger (int32)

Number of reveal (is used to reveal the public key associated with an account) operations of the contract.

numMigrationsinteger (int32)

Number of migration (result of the context (database) migration during a protocol update) operations. related to the contract (synthetic type).

transferTicketCountinteger (int32)

Number of transfer ticket operations related to the contract.

increasePaidStorageCountinteger (int32)

Number of increase_paid_storage operations related to the contract.

eventsCountinteger (int32)

Number of events produced by the contract.

firstActivityinteger (int32)

Block height of the contract creation.
[sortable]

firstActivityTimestring (date-time)

Block datetime of the contract creation (ISO 8601, e.g. 2020-02-20T02:40:57Z).

lastActivityinteger (int32)

Height of the block in which the account state was changed last time.
[sortable]

lastActivityTimestring (date-time)

Datetime of the block in which the account state was changed last time (ISO 8601, e.g. 2020-02-20T02:40:57Z).

typeHashinteger (int32)

32-bit hash of the contract parameter and storage types. This field can be used for searching similar contracts (which have the same interface).

codeHashinteger (int32)

32-bit hash of the contract code. This field can be used for searching same contracts (which have the same script).

metadatanullable any

TZIP-16 metadata (with ?legacy=true this field will contain tzkt profile info).

extrasnullable any

Off-chain extras.

storagenullable any

Contract storage value. Omitted by default. Use ?includeStorage=true to include it into response.

Request

JavaScriptCurlPython

const response = await fetch('https://xtz-index.nownodes.io/v1/contracts', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "type": "text",
    "id": 0,
    "address": "text",
    "kind": "text",
    "tzips": [
      "text"
    ],
    "alias": "text",
    "balance": 0,
    "creator": {
      "alias": "text",
      "address": "text"
    },
    "manager": {
      "alias": "text",
      "address": "text",
      "publicKey": "text"
    },
    "delegate": {
      "alias": "text",
      "address": "text",
      "active": false
    },
    "delegationLevel": 0,
    "delegationTime": "2024-12-22T02:07:00.130Z",
    "numContracts": 0,
    "tokensCount": 0,
    "activeTokensCount": 0,
    "tokenBalancesCount": 0,
    "tokenTransfersCount": 0,
    "ticketsCount": 0,
    "activeTicketsCount": 0,
    "ticketBalancesCount": 0,
    "ticketTransfersCount": 0,
    "numDelegations": 0,
    "numOriginations": 0,
    "numTransactions": 0,
    "numReveals": 0,
    "numMigrations": 0,
    "transferTicketCount": 0,
    "increasePaidStorageCount": 0,
    "eventsCount": 0,
    "firstActivity": 0,
    "firstActivityTime": "2024-12-22T02:07:00.130Z",
    "lastActivity": 0,
    "lastActivityTime": "2024-12-22T02:07:00.130Z",
    "typeHash": 0,
    "codeHash": 0
  }
]

Get contract by address

Returns a contract account with the specified address.

GEThttps://xtz-index.nownodes.io/v1/contracts/{address}

Path parameters

address*string

Contract address (starting with KT)

Query parameters

Response

200

Body

application/json

type*string

idinteger (int32)

Internal TzKT id.
[sortable]

typenullable string

Type of the account, contract - smart contract programmable account.

addressnullable string

Public key hash of the contract

kindnullable string

Kind of the contract (delegator_contract or smart_contract), where delegator_contract - manager.tz smart contract for delegation purpose only.

tzipsnullable array of string

List of implemented standards (TZIPs).

aliasnullable string

Name of the project behind the contract or contract description.

balanceinteger (int64)

Contract balance (micro tez).
[sortable]

creatornullable one of

Information about the account, which has deployed the contract to the blockchain.
Click on the field to expand more details.

CreatorInfo (object)

managernullable one of

Information about the account, which was marked as a manager when contract was deployed to the blockchain.
Click on the field to expand more details.

ManagerInfo (object)

delegatenullable one of

Information about the current delegate of the contract. null if it's not delegated.
Click on the field to expand more details.

DelegateInfo (object)

delegationLevelnullable integer (int32)

Block height of latest delegation. null if it's not delegated.

delegationTimenullable string (date-time)

Block datetime of latest delegation (ISO 8601, e.g. 2020-02-20T02:40:57Z). null if it's not delegated.

numContractsinteger (int32)

Number of contracts, created (originated) and/or managed by the contract.

tokensCountinteger (int32)

Number of tokens minted in the contract.

activeTokensCountinteger (int32)

Number of account tokens with non-zero balances.

tokenBalancesCountinteger (int32)

Number of tokens the account ever had.

tokenTransfersCountinteger (int32)

Number of token transfers from/to the account.

ticketsCountinteger (int32)

Number of tickets minted in the contract.

activeTicketsCountinteger (int32)

Number of tickets the account owns.

ticketBalancesCountinteger (int32)

Number of tickets the account ever owned.

ticketTransfersCountinteger (int32)

Number of ticket transfers from/to the account.

numDelegationsinteger (int32)

Number of delegation operations of the contract.

numOriginationsinteger (int32)

Number of origination (deployment / contract creation) operations, related the contract.

numTransactionsinteger (int32)

Number of transaction (transfer) operations, related to the contract.
[sortable]

numRevealsinteger (int32)

Number of reveal (is used to reveal the public key associated with an account) operations of the contract.

numMigrationsinteger (int32)

Number of migration (result of the context (database) migration during a protocol update) operations. related to the contract (synthetic type).

transferTicketCountinteger (int32)

Number of transfer ticket operations related to the contract.

increasePaidStorageCountinteger (int32)

Number of increase_paid_storage operations related to the contract.

eventsCountinteger (int32)

Number of events produced by the contract.

firstActivityinteger (int32)

Block height of the contract creation.
[sortable]

firstActivityTimestring (date-time)

Block datetime of the contract creation (ISO 8601, e.g. 2020-02-20T02:40:57Z).

lastActivityinteger (int32)

Height of the block in which the account state was changed last time.
[sortable]

lastActivityTimestring (date-time)

Datetime of the block in which the account state was changed last time (ISO 8601, e.g. 2020-02-20T02:40:57Z).

typeHashinteger (int32)

32-bit hash of the contract parameter and storage types. This field can be used for searching similar contracts (which have the same interface).

codeHashinteger (int32)

32-bit hash of the contract code. This field can be used for searching same contracts (which have the same script).

metadatanullable any

TZIP-16 metadata (with ?legacy=true this field will contain tzkt profile info).

extrasnullable any

Off-chain extras.

storagenullable any

Contract storage value. Omitted by default. Use ?includeStorage=true to include it into response.

Request

JavaScriptCurlPython

const response = await fetch('https://xtz-index.nownodes.io/v1/contracts/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "type": "text",
  "id": 0,
  "address": "text",
  "kind": "text",
  "tzips": [
    "text"
  ],
  "alias": "text",
  "balance": 0,
  "creator": {
    "alias": "text",
    "address": "text"
  },
  "manager": {
    "alias": "text",
    "address": "text",
    "publicKey": "text"
  },
  "delegate": {
    "alias": "text",
    "address": "text",
    "active": false
  },
  "delegationLevel": 0,
  "delegationTime": "2024-12-22T02:07:00.130Z",
  "numContracts": 0,
  "tokensCount": 0,
  "activeTokensCount": 0,
  "tokenBalancesCount": 0,
  "tokenTransfersCount": 0,
  "ticketsCount": 0,
  "activeTicketsCount": 0,
  "ticketBalancesCount": 0,
  "ticketTransfersCount": 0,
  "numDelegations": 0,
  "numOriginations": 0,
  "numTransactions": 0,
  "numReveals": 0,
  "numMigrations": 0,
  "transferTicketCount": 0,
  "increasePaidStorageCount": 0,
  "eventsCount": 0,
  "firstActivity": 0,
  "firstActivityTime": "2024-12-22T02:07:00.130Z",
  "lastActivity": 0,
  "lastActivityTime": "2024-12-22T02:07:00.130Z",
  "typeHash": 0,
  "codeHash": 0
}