Contracts

PreviousCount NextCount

Get contracts

Returns a list of contract accounts.

get

/v1/contracts

Query parameters

idnullable one of

Filter by internal TzKT id.
Click on the parameter to expand more details.

addressnullable one of

Filter by address.
Click on the parameter to expand more details.

kindnullable one of

Filter by kind (delegator_contract, smart_contract, or asset).
Click on the parameter to expand more details.

tzipsnullable one of

Filter by tzips (fa1, fa12, or fa2).
Click on the parameter to expand more details.

balancenullable one of

Filter by balance.
Click on the parameter to expand more details.

creatornullable one of

Filter by creator.
Click on the parameter to expand more details.

managernullable one of

Filter by manager.
Click on the parameter to expand more details.

delegatenullable one of

Filter by delegate.
Click on the parameter to expand more details.

firstActivitynullable one of

Filter by level of the block where the contract was first seen.
Click on the parameter to expand more details.

firstActivityTimenullable one of

Filter by timestamp (ISO 8601) of the block where the contract was first seen.
Click on the parameter to expand more details.

lastActivitynullable one of

Filter by level of the block where the contract was last seen.
Click on the parameter to expand more details.

lastActivityTimenullable one of

Filter by timestamp (ISO 8601) of the block where the contract was last seen.
Click on the parameter to expand more details.

typeHashnullable one of

Filter by 32-bit hash of contract parameter and storage types (helpful for searching similar contracts).
Click on the parameter to expand more details.

codeHashnullable one of

Filter by 32-bit hash of contract code (helpful for searching same contracts).
Click on the parameter to expand more details.

sortnullable one of

Sorts items (asc or desc) by the specified field. You can see what fields can be used for sorting in the response description, below.
Click on the parameter to expand more details.

offsetnullable one of

Specifies which or how many items should be skipped.
Click on the parameter to expand more details.

limitinteger int32

Maximum number of items to return.

selectnullable one of

Specify a comma-separated list of fields to include into response or leave it undefined to get default set of fields. This parameter accepts values of the following format: {field}{path?}{as alias?}, so you can do deep selection (for example, ?select=balance,token.metadata.symbol as token,...).
Note, if you select just one field, the response will be flatten into a simple array of values.
Click on the parameter to expand the details.

includeStorageboolean

Specifies whether to include contract storage into response.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://xtz-index.nownodes.io/v1/contracts'

200

[
  {
    "type": "text",
    "id": 1,
    "address": "text",
    "kind": "text",
    "tzips": [
      "text"
    ],
    "alias": "text",
    "balance": 1,
    "creator": {
      "alias": "text",
      "address": "text"
    },
    "manager": {
      "alias": "text",
      "address": "text",
      "publicKey": "text"
    },
    "delegate": {
      "alias": "text",
      "address": "text",
      "active": true
    },
    "delegationLevel": 1,
    "delegationTime": "2025-02-06T10:29:39.562Z",
    "numContracts": 1,
    "tokensCount": 1,
    "activeTokensCount": 1,
    "tokenBalancesCount": 1,
    "tokenTransfersCount": 1,
    "ticketsCount": 1,
    "activeTicketsCount": 1,
    "ticketBalancesCount": 1,
    "ticketTransfersCount": 1,
    "numDelegations": 1,
    "numOriginations": 1,
    "numTransactions": 1,
    "numReveals": 1,
    "numMigrations": 1,
    "transferTicketCount": 1,
    "increasePaidStorageCount": 1,
    "eventsCount": 1,
    "firstActivity": 1,
    "firstActivityTime": "2025-02-06T10:29:39.562Z",
    "lastActivity": 1,
    "lastActivityTime": "2025-02-06T10:29:39.562Z",
    "typeHash": 1,
    "codeHash": 1,
    "metadata": null,
    "extras": null,
    "storage": null
  }
]

Get contract by address

Returns a contract account with the specified address.

get

/v1/contracts/{address}

Path parameters

addressstringrequired

Contract address (starting with KT)