Contracts

Get contract by address

Returns a contract account with the specified address.

get/v1/contracts/{address}

Path parameters

addressstring required

Contract address (starting with KT)

Response

idinteger

Internal TzKT id.
[sortable]

typestring

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

addressstring required

Public key hash of the contract

kindstring required

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

tzipsstring[] nullable

List of implemented standards (TZIPs).

aliasstring nullable

Name of the project behind the contract or contract description.

balanceinteger

Contract balance (micro tez).
[sortable]

delegationLevelinteger nullable

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

delegationTimestring date-time nullable

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

numContractsinteger

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

tokensCountinteger

Number of tokens minted in the contract.

activeTokensCountinteger

Number of account tokens with non-zero balances.

tokenBalancesCountinteger

Number of tokens the account ever had.

tokenTransfersCountinteger

Number of token transfers from/to the account.

ticketsCountinteger

Number of tickets minted in the contract.

activeTicketsCountinteger

Number of tickets the account owns.

ticketBalancesCountinteger

Number of tickets the account ever owned.

ticketTransfersCountinteger

Number of ticket transfers from/to the account.

numDelegationsinteger

Number of delegation operations of the contract.

numOriginationsinteger

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

numTransactionsinteger

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

numRevealsinteger

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

numMigrationsinteger

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

transferTicketCountinteger

Number of transfer ticket operations related to the contract.

increasePaidStorageCountinteger

Number of increase_paid_storage operations related to the contract.

eventsCountinteger

Number of events produced by the contract.

firstActivityinteger

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

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

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

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

{"stackTrail":"components:schemas:Contract:allOf:properties:metadata","oasType":"schema","type":"unknown","description":"TZIP-16 metadata.","nullable":true}

{"stackTrail":"components:schemas:Contract:allOf:properties:extras","oasType":"schema","type":"unknown","description":"Off-chain extras.","nullable":true}

{"stackTrail":"components:schemas:Contract:allOf:properties:storage","oasType":"schema","type":"unknown","description":"Contract storage value. Omitted by default. Use `?includeStorage=true` to include it into response.","nullable":true}

Changes

No recorded changes to this endpoint across all 1 revision of this API.