tokens

Get tokens

Query tokens

get/v1/tokens

Request

Base URL: https://insight.thirdweb.com
URL: https://insight.thirdweb.com/v1/tokens
Auth: API key in header x-client-id

Query parameters

chainnumber[]

Use chain_id instead

[
  20,
  56,
  1
]

chain_idnumber[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

[
  20,
  56,
  1
]

limitinteger

The number of items to return

Example:20

pageinteger nullable

Page number (0-indexed)

metadata'true' | 'false'

Whether to include metadata for the tokens

Example:false

resolve_metadata_links'true' | 'false'

Whether to resolve metadata IPFS or Arweave links

Example:false

include_spam'true' | 'false'

Whether to include spam tokens

Example:false

owner_addressstring[] required

Address(es) to filter by. You can specify multiple addresses using repeated query parameters, e.g., ?address=0x123&address=0x456

[
  "0x1234567890123456789012345678901234567890",
  "vitalik.eth"
]

include_native'true' | 'false'

Whether to include native tokens

Example:true

token_addressstring[]

Address(es) to filter by. You can specify multiple addresses using repeated query parameters, e.g., ?address=0x123&address=0x456

[
  "0x1234567890123456789012345678901234567890",
  "vitalik.eth"
]

sort_by'balance' | 'token_address' | 'token_price' | 'usd_value'

Field to sort by

Example:balance

sort_order'asc' | 'desc'

Sort order (asc or desc)

Example:desc

include_without_price'true' | 'false'

Whether to include tokens that don't have price data (only applies when metadata=true)

Example:true

Response

Successful response

Example response

{
  "data": [
    {
      "chain_id": 1,
      "token_address": "vitalik.eth"
    }
  ]
}

Changes

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