Get contracts
Returns a list of contract accounts.
Query parameters
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by internal TzKT id.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq= is the same as param=).
Specify an account address to get items where the specified field is equal to the specified value.
Example: ?address=tz123...
Not equal filter mode.
Specify an account address to get items where the specified field is not equal to the specified value.
Example: ?address.ne=tz123...
In list (any of) filter mode.
Specify a comma-separated list of account addresses to get items where the specified field is equal to one of the specified values.
Example: ?address.in=tz123..,tz345...
Not in list (none of) filter mode.
Specify a comma-separated list of account addresses to get items where the specified field is not equal to all the specified values.
Example: ?address.ni=tz123..,tz345...
Filter by address.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a contract kind to get items where the specified field is equal to the specified value.
Example: ?kind=smart_contract.
Not equal filter mode.
Specify a contract kind to get items where the specified field is not equal to the specified value.
Example: ?kind.ne=delegator_contract.
In list (any of) filter mode.
Specify a comma-separated list of contract kinds to get items where the specified field is equal to one of the specified values.
Example: ?kind.in=smart_contract,asset.
Not in list (none of) filter mode.
Specify a comma-separated list of contract kinds to get items where the specified field is not equal to all the specified values.
Example: ?kind.ni=smart_contract,asset.
Filter by kind (delegator_contract, smart_contract, or asset).
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a comma-separated list of contract tags to get contracts with exactly the same set of tags.
Avoid using this mode and use .any or .all instead, because it may not work as expected due to internal 'hidden' tags.
Example: ?tags=fa2 or ?tags=fa1,fa12.
Has any filter mode.
Specify a comma-separated list of contract tags to get contracts where at least one of the specified tags is presented.
Example: ?tags.any=fa2 or ?tags.any=fa1,fa12.
Has all filter mode.
Specify a comma-separated list of contract tags to get contracts where all of the specified tags are presented.
Example: ?tags.all=fa2 or ?tags.all=fa1,fa12.
Filter by tzips (fa1, fa12, or fa2).
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by balance.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a tz or KT address to get items where the specified field is equal to the specified value.
Example: ?sender=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.
Not equal filter mode.
Specify a tz or KT address to get items where the specified field is not equal to the specified value.
Example: ?sender.ne=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.
In list (any of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is equal to one of the specified values.
Example: ?sender.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.
Not in list (none of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is not equal to all the specified values.
Example: ?sender.ni=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.
Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.
Example: ?sender.eqx=target.
Not equal to another field filter mode.
Specify a field name to get items where the specified fields are not equal.
Example: ?sender.nex=initiator.
Is null filter mode.
Use this mode to get items where the specified field is null or not.
Example: ?initiator.null or ?initiator.null=false.
Filter by creator.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a tz or KT address to get items where the specified field is equal to the specified value.
Example: ?sender=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.
Not equal filter mode.
Specify a tz or KT address to get items where the specified field is not equal to the specified value.
Example: ?sender.ne=tz1WnfXMPaNTBmH7DBPwqCWs9cPDJdkGBTZ8.
In list (any of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is equal to one of the specified values.
Example: ?sender.in=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.
Not in list (none of) filter mode.
Specify a comma-separated list of addresses to get items where the specified field is not equal to all the specified values.
Example: ?sender.ni=tz1WnfXMPaNTBWnfXMPaNTBWnfXMPaNTBNTB,tz1SiPXX4MYGNJNDSiPXX4MYGNJNDSiPXX4M.
Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.
Example: ?sender.eqx=target.
Not equal to another field filter mode.
Specify a field name to get items where the specified fields are not equal.
Example: ?sender.nex=initiator.
Is null filter mode.
Use this mode to get items where the specified field is null or not.
Example: ?initiator.null or ?initiator.null=false.
Filter by delegate.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by level of the block where the contract was first seen.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a datetime value to get items where the specified field is equal to the specified value.
Example: ?timestamp=2020-02-20T02:40:57Z.
Not equal filter mode.
Specify a datetime value to get items where the specified field is not equal to the specified value.
Example: ?timestamp.ne=2020-02-20T02:40:57Z.
Greater than filter mode.
Specify a datetime value to get items where the specified field is greater than the specified value.
Example: ?timestamp.gt=2020-02-20T02:40:57Z.
Greater or equal filter mode.
Specify a datetime value to get items where the specified field is greater than equal to the specified value.
Example: ?timestamp.ge=2020-02-20T02:40:57Z.
Less than filter mode.
Specify a datetime value to get items where the specified field is less than the specified value.
Example: ?timestamp.lt=2020-02-20T02:40:57Z.
Less or equal filter mode.
Specify a datetime value to get items where the specified field is less than or equal to the specified value.
Example: ?timestamp.le=2020-02-20T02:40:57Z.
In list (any of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is equal to one of the specified values.
Example: ?timestamp.in=2020-02-20,2020-02-21.
Not in list (none of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is not equal to all the specified values.
Example: ?timestamp.ni=2020-02-20,2020-02-21.
Filter by timestamp (ISO 8601) of the block where the contract was first seen.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by level of the block where the contract was last seen.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a datetime value to get items where the specified field is equal to the specified value.
Example: ?timestamp=2020-02-20T02:40:57Z.
Not equal filter mode.
Specify a datetime value to get items where the specified field is not equal to the specified value.
Example: ?timestamp.ne=2020-02-20T02:40:57Z.
Greater than filter mode.
Specify a datetime value to get items where the specified field is greater than the specified value.
Example: ?timestamp.gt=2020-02-20T02:40:57Z.
Greater or equal filter mode.
Specify a datetime value to get items where the specified field is greater than equal to the specified value.
Example: ?timestamp.ge=2020-02-20T02:40:57Z.
Less than filter mode.
Specify a datetime value to get items where the specified field is less than the specified value.
Example: ?timestamp.lt=2020-02-20T02:40:57Z.
Less or equal filter mode.
Specify a datetime value to get items where the specified field is less than or equal to the specified value.
Example: ?timestamp.le=2020-02-20T02:40:57Z.
In list (any of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is equal to one of the specified values.
Example: ?timestamp.in=2020-02-20,2020-02-21.
Not in list (none of) filter mode.
Specify a comma-separated list of datetimes to get items where the specified field is not equal to all the specified values.
Example: ?timestamp.ni=2020-02-20,2020-02-21.
Filter by timestamp (ISO 8601) of the block where the contract was last seen.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by 32-bit hash of contract parameter and storage types (helpful for searching similar contracts).
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by 32-bit hash of contract code (helpful for searching same contracts).
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by number of different tokens minted within the contract.
Click on the parameter to expand more details.
Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify an integer number to get items where the specified field is equal to the specified value.
Example: ?balance=1234.
Not equal filter mode.
Specify an integer number to get items where the specified field is not equal to the specified value.
Example: ?balance.ne=1234.
Greater than filter mode.
Specify an integer number to get items where the specified field is greater than the specified value.
Example: ?balance.gt=1234.
Greater or equal filter mode.
Specify an integer number to get items where the specified field is greater than equal to the specified value.
Example: ?balance.ge=1234.
Less than filter mode.
Specify an integer number to get items where the specified field is less than the specified value.
Example: ?balance.lt=1234.
Less or equal filter mode.
Specify an integer number to get items where the specified field is less than or equal to the specified value.
Example: ?balance.le=1234.
In list (any of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is equal to one of the specified values.
Example: ?level.in=12,14,52,69.
Not in list (none of) filter mode.
Specify a comma-separated list of integers to get items where the specified field is not equal to all the specified values.
Example: ?level.ni=12,14,52,69.
Filter by number of different tickets minted within the contract.
Click on the parameter to expand more details.
Ascending sort mode (optional, i.e. sort.asc=id is the same as sort=id).
Specify a field name to sort by.
Example: ?sort=balance.
Descending sort mode.
Specify a field name to sort by descending.
Example: ?sort.desc=id.
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.
Elements offset mode (optional, i.e. offset.el=123 is the same as offset=123).
Skips specified number of elements.
Example: ?offset=100.
Page offset mode.
Skips page * limit elements. This is a classic pagination.
Example: ?offset.pg=1.
Cursor offset mode.
Skips all elements with the cursor before (including) the specified value. Cursor is a field used for sorting, e.g. id.
Avoid using this offset mode with non-unique or non-sequential cursors such as amount, balance, etc.
Example: ?offset.cr=45837.
Specifies which or how many items should be skipped.
Click on the parameter to expand more details.
Maximum number of items to return.
Fields selection mode (optional, i.e. select.fields=balance is the same as select=balance).
Specify a comma-separated list of fields to include into response.
Example: ?select=address,balance as b,metadata.name as meta_name will result in [ { "address": "asd", "b": 10, "meta_name": "qwe" } ].
Values selection mode.
Specify a comma-separated list of fields to include their values into response.
Example: ?select.values=address,balance,metadata.name will result in [ [ "asd", 10, "qwe" ] ].
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.
Specifies whether to include contract storage into response.
Response
Internal TzKT id.
[sortable]
Type of the account, contract - smart contract programmable account.
Public key hash of the contract
Kind of the contract (delegator_contract or smart_contract), where delegator_contract - manager.tz smart contract for delegation purpose only.
List of implemented standards (TZIPs).
Name of the project behind the contract or contract description.
Contract balance (micro tez).
[sortable]
Block height of latest delegation. null if it's not delegated.
Block datetime of latest delegation (ISO 8601, e.g. 2020-02-20T02:40:57Z). null if it's not delegated.
Number of contracts, created (originated) and/or managed by the contract.
Number of tokens minted in the contract.
Number of account tokens with non-zero balances.
Number of tokens the account ever had.
Number of token transfers from/to the account.
Number of tickets minted in the contract.
Number of tickets the account owns.
Number of tickets the account ever owned.
Number of ticket transfers from/to the account.
Number of delegation operations of the contract.
Number of origination (deployment / contract creation) operations, related the contract.
Number of transaction (transfer) operations, related to the contract.
[sortable]
Number of reveal (is used to reveal the public key associated with an account) operations of the contract.
Number of migration (result of the context (database) migration during a protocol update) operations. related to the contract (synthetic type).
Number of transfer ticket operations related to the contract.
Number of increase_paid_storage operations related to the contract.
Number of events produced by the contract.
Block height of the contract creation.
[sortable]
Block datetime of the contract creation (ISO 8601, e.g. 2020-02-20T02:40:57Z).
Height of the block in which the account state was changed last time.
[sortable]
Datetime of the block in which the account state was changed last time (ISO 8601, e.g. 2020-02-20T02:40:57Z).
32-bit hash of the contract parameter and storage types. This field can be used for searching similar contracts (which have the same interface).
32-bit hash of the contract code. This field can be used for searching same contracts (which have the same script).
Changes
No recorded changes to this endpoint across all 1 revision of this API.