Tokens

Get tokens

Returns a list of tokens.

get/v1/tokens

Query parameters

eqinteger nullable

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.

neinteger nullable

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.

gtinteger nullable

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.

geinteger nullable

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.

ltinteger nullable

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.

leinteger nullable

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.

ininteger[] nullable

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.

niinteger[] nullable

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.

emptyboolean

Filter by internal TzKT id. Note, this is not the same as tokenId nat value.
Click on the parameter to expand more details.

eqstring nullable

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.

nestring nullable

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.

instring[] nullable

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.

nistring[] nullable

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.

eqxstring nullable

Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.

Example: ?sender.eqx=target.

nexstring nullable

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.

nullboolean nullable

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 contract address.
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a nat value to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

nestring nullable

Not equal filter mode.
Specify a nat value to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtstring nullable

Greater than filter mode.
Specify a nat value to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

gestring nullable

Greater or equal filter mode.
Specify a nat value to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltstring nullable

Less than filter mode.
Specify a nat value to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

lestring nullable

Less or equal filter mode.
Specify a nat value to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filter by tokenId (for FA1.2 tokens tokenId is always "0").
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify token standard (fa1.2 or fa2) to get items where the specified field is equal to the specified value.

Example: ?type=fa2.

instring nullable

Not equal filter mode.
Specify token standard (fa1.2 or fa2) to get items where the specified field is not equal to the specified value.

Example: ?type.ne=fa1.2.

Filter by "global id", which is a "{contract}:{tokenId}" string.
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify token standard (fa1.2 or fa2) to get items where the specified field is equal to the specified value.

Example: ?type=fa2.

nestring nullable

Not equal filter mode.
Specify token standard (fa1.2 or fa2) to get items where the specified field is not equal to the specified value.

Example: ?type.ne=fa1.2.

Filter by token standard (fa1.2 or fa2).
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a nat value to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

nestring nullable

Not equal filter mode.
Specify a nat value to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtstring nullable

Greater than filter mode.
Specify a nat value to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

gestring nullable

Greater or equal filter mode.
Specify a nat value to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltstring nullable

Less than filter mode.
Specify a nat value to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

lestring nullable

Less or equal filter mode.
Specify a nat value to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filter by total minted.
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a nat value to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

nestring nullable

Not equal filter mode.
Specify a nat value to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtstring nullable

Greater than filter mode.
Specify a nat value to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

gestring nullable

Greater or equal filter mode.
Specify a nat value to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltstring nullable

Less than filter mode.
Specify a nat value to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

lestring nullable

Less or equal filter mode.
Specify a nat value to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filter by total burned. Note: total burned shows only those tokens that were literally burned, excluding tokens sent to burn addresses (because they still exist on the burn address' balance).
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a nat value to get items where the specified field is equal to the specified value.

Example: ?balance=1234.

nestring nullable

Not equal filter mode.
Specify a nat value to get items where the specified field is not equal to the specified value.

Example: ?balance.ne=1234.

gtstring nullable

Greater than filter mode.
Specify a nat value to get items where the specified field is greater than the specified value.

Example: ?balance.gt=1234.

gestring nullable

Greater or equal filter mode.
Specify a nat value to get items where the specified field is greater than equal to the specified value.

Example: ?balance.ge=1234.

ltstring nullable

Less than filter mode.
Specify a nat value to get items where the specified field is less than the specified value.

Example: ?balance.lt=1234.

lestring nullable

Less or equal filter mode.
Specify a nat value to get items where the specified field is less than or equal to the specified value.

Example: ?balance.le=1234.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is equal to one of the specified values.

Example: ?level.in=12,14,52,69.

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of nat values to get items where the specified field is not equal to all the specified values.

Example: ?level.ni=12,14,52,69.

Filter by total supply. Note: total supply shows all existing tokens, including tokens sent to burn addresses (so that they exist on the burn address' balance).
Click on the parameter to expand more details.

eqstring nullable

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.

nestring nullable

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.

instring[] nullable

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.

nistring[] nullable

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.

eqxstring nullable

Equal to another field filter mode.
Specify a field name to get items where the specified fields are equal.

Example: ?sender.eqx=target.

nexstring nullable

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.

nullboolean nullable

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 address of the first minter.
Click on the parameter to expand more details.

eqinteger nullable

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.

neinteger nullable

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.

gtinteger nullable

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.

geinteger nullable

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.

ltinteger nullable

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.

leinteger nullable

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.

ininteger[] nullable

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.

niinteger[] nullable

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 token was first seen.
Click on the parameter to expand more details.

eqstring date-time nullable

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.

nestring date-time nullable

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.

gtstring date-time nullable

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.

gestring date-time nullable

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.

ltstring date-time nullable

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.

lestring date-time nullable

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.

instring[] nullable

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.

nistring[] nullable

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 token was first seen.
Click on the parameter to expand more details.

eqinteger nullable

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.

neinteger nullable

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.

gtinteger nullable

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.

geinteger nullable

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.

ltinteger nullable

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.

leinteger nullable

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.

ininteger[] nullable

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.

niinteger[] nullable

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 token was last seen.
Click on the parameter to expand more details.

eqstring date-time nullable

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.

nestring date-time nullable

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.

gtstring date-time nullable

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.

gestring date-time nullable

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.

ltstring date-time nullable

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.

lestring date-time nullable

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.

instring[] nullable

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.

nistring[] nullable

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 token was last seen.
Click on the parameter to expand more details.

eqstring nullable

Equal filter mode (optional, i.e. param.eq=123 is the same as param=123).
Specify a JSON value to get items where the specified field is equal to the specified value.

Example: ?parameter.from=tz1... or ?parameter.signatures.[3].[0]=null or ?parameter.sigs.[*]=null.

nestring nullable

Not equal filter mode.
Specify a JSON value to get items where the specified field is not equal to the specified value.

Example: ?parameter.ne=true or ?parameter.amount.ne=0.

gtstring nullable

Greater than filter mode.
Specify a string to get items where the specified field is greater than the specified value. Note that all stored JSON values are strings, so this will be a comparison of two strings, so we recommend comparing values of the same type, e.g. numeric strings with numeric strings (parameter.number.gt=123), datetime strings with datetime strings (parameter.date.gt=2021-01-01), etc. Otherwise, result may surprise you.

Example: ?parameter.balance.gt=1234 or ?parameter.time.gt=2021-02-01.

gestring nullable

Greater or equal filter mode.
Specify a string to get items where the specified field is greater than equal to the specified value. Note that all stored JSON values are strings, so this will be a comparison of two strings, so we recommend comparing values of the same type, e.g. numeric strings with numeric strings (parameter.number.gt=123), datetime strings with datetime strings (parameter.date.gt=2021-01-01), etc. Otherwise, result may surprise you.

Example: ?parameter.balance.ge=1234 or ?parameter.time.ge=2021-02-01.

ltstring nullable

Less than filter mode.
Specify a string to get items where the specified field is less than the specified value. Note that all stored JSON values are strings, so this will be a comparison of two strings, so we recommend comparing values of the same type, e.g. numeric strings with numeric strings (parameter.number.gt=123), datetime strings with datetime strings (parameter.date.gt=2021-01-01), etc. Otherwise, result may surprise you.

Example: ?parameter.balance.lt=1234 or ?parameter.time.lt=2021-02-01.

lestring nullable

Less or equal filter mode.
Specify a string to get items where the specified field is less than or equal to the specified value. Note that all stored JSON values are strings, so this will be a comparison of two strings, so we recommend comparing values of the same type, e.g. numeric strings with numeric strings (parameter.number.gt=123), datetime strings with datetime strings (parameter.date.gt=2021-01-01), etc. Otherwise, result may surprise you.

Example: ?parameter.balance.le=1234 or ?parameter.time.le=2021-02-01.

asstring nullable

Same as filter mode.
Specify a string template to get items where the specified field matches the specified template.
This mode supports wildcard *. Use \* as an escape symbol.

Example: ?parameter.as=*mid* or ?parameter.as=*end.

unstring nullable

Unlike filter mode.
Specify a string template to get items where the specified field doesn't match the specified template. This mode supports wildcard *. Use \* as an escape symbol.

Example: ?parameter.un=*mid* or ?parameter.un=*end.

instring[] nullable

In list (any of) filter mode.
Specify a comma-separated list of strings or JSON array to get items where the specified field is equal to one of the specified values. \

Example: ?parameter.amount.in=1,2,3 or ?parameter.in=[{"from":"tz1","to":"tz2"},{"from":"tz2","to":"tz1"}].

nistring[] nullable

Not in list (none of) filter mode.
Specify a comma-separated list of strings to get items where the specified field is not equal to all the specified values.
Use \, as an escape symbol.

Example: ?parameter.amount.ni=1,2,3 or ?parameter.ni=[{"from":"tz1","to":"tz2"},{"from":"tz2","to":"tz1"}].

nullboolean

Is null filter mode.
Use this mode to get items where the specified field is null or not.

Example: ?parameter.null or ?parameter.null=false or ?parameter.sigs.[0].null=false.

Filter by metadata.
Note, this parameter supports the following format: metadata{.path?}{.mode?}=..., so you can specify a path to a particular field to filter by (for example, ?metadata.symbol.in=kUSD,uUSD).
Click on the parameter to expand more details.

ascstring nullable

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.

descstring nullable

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.

elinteger nullable

Elements offset mode (optional, i.e. offset.el=123 is the same as offset=123).
Skips specified number of elements.

Example: ?offset=100.

pginteger nullable

Page offset mode.
Skips page * limit elements. This is a classic pagination.

Example: ?offset.pg=1.

crinteger nullable

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.

limitinteger

Maximum number of items to return.

fieldsstring[] nullable

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" } ].

valuesstring[] nullable

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.

Response

idinteger

Internal TzKT id (not the same as tokenId).
[sortable]

tokenIdstring

Token id, unique within the contract.
[sortable]

standardstring required

Token standard (fa1.2 or fa2).

firstLevelinteger

Level of the block where the token was first seen.
[sortable]

firstTimestring date-time

Timestamp of the block where the token was first seen.

lastLevelinteger

Level of the block where the token was last seen.
[sortable]

lastTimestring date-time

Timestamp of the block where the token was last seen.

transfersCountinteger

Total number of transfers.
[sortable]

balancesCountinteger

Total number of holders ever seen.
[sortable]

holdersCountinteger

Total number of current holders.
[sortable]

totalMintedstring

Total number of minted tokens (raw value, not divided by decimals).

totalBurnedstring

Total number of burned tokens (raw value, not divided by decimals).

totalSupplystring

Total number of existing tokens (raw value, not divided by decimals).

{"stackTrail":"components:schemas:Token:properties:metadata","oasType":"schema","type":"unknown","description":"Token metadata. \n**[sortable]**","nullable":true}

Changes

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