Returns a list of tokens matching a given query string.
Deprecated
This endpoint is deprecated and will no longer be supported or maintained after May 8th, 2024.
To search tokens, use the much more powerful and flexible
filterTokensendpoint.
Endpoint: searchTokens
Method: POST
Arguments
| Name | Type | Description |
|---|---|---|
| limit | Int | The maximum number of tokens to return. |
| lowVolumeFilter | Boolean | Whether to filter out low volume results from the response. Low volume is less than $500 USD. This setting has no effect when only low volume results are found. Default is |
| networkFilter | [Int!] | The list of network IDs to filter by. |
| resolution | String | The time frame to use for token metadata. Can be |
| search | String! | The query string to search for. Can match a token or pair contract address or partially match a token's name or symbol. Automatically filters out tokens marked as scams. Required |
Response
| Name | Type | Description |
|---|---|---|
| hasMore | Int | The number of additional high volume results found. Only used if lowVolumeFilter is set to true. |
| hasMoreLowVolume | Int | If lowVolumeFilter is set to true, the number of additional low volume results found. If lowVolumeFilter is set to false, the number of additional high and low volume results found. |
| tokens | [TokenWithMetadata!] | A list of tokens. |
| Name | Type | Description |
|---|---|---|
| address | String! | The contract address of the token. |
| createdAt | Int | The unix timestamp for the creation of the token's first pair. |
| decimals | Int | The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals). |
| exchanges | [Exchange!]! | The exchanges the token is listed on. |
| id | String! | The ID of the token (address:networkId). For example, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1. |
| imageBannerUrl | String | The token banner URL. |
| imageLargeUrl | String | The token logo URL. |
| imageSmallUrl | String | The token logo URL. |
| imageThumbUrl | String | The token logo URL. |
| isScam | Boolean | Whether the token has been flagged as a scam. |
| lastTransaction | Int | The unix timestamp for the token's last transaction. |
| liquidity | String! | The total liquidity of the token's top pair in USD. |
| marketCap | String | The market cap of circulating supply. |
| name | String! | The name of the token. |
| networkId | Int! | The network ID the token is deployed on. |
| price | Float! | The token price in USD. |
| priceChange | Float! | The percent price change for the time frame requested. Decimal format. |
| priceChange1 | Float | The percent price change in the past hour. Decimal format. |
| priceChange4 | Float | The percent price change in the past 4 hours. Decimal format. |
| priceChange12 | Float | The percent price change in the past 12 hours. Decimal format. |
| priceChange24 | Float | The percent price change in the past 24 hours. Decimal format. |
| quoteToken | QuoteToken | The token of interest. Can be token0 or token1. |
| resolution | String! | The time frame for the results. |
| symbol | String! | The symbol for the token. |
| topPairId | String! | The ID of the token's top pair (pairAddress:networkId). |
| txnCount1 | Int | The number of transactions in the past hour. |
| txnCount4 | Int | The number of transactions in the past 4 hours. |
| txnCount12 | Int | The number of transactions in the past 12 hours. |
| txnCount24 | Int | The number of transactions in the past 24 hours. |
| uniqueBuys1 | Int | The unique number of buys in the past hour. |
| uniqueBuys4 | Int | The unique number of buys in the past 4 hours. |
| uniqueBuys12 | Int | The unique number of buys in the past 12 hours. |
| uniqueBuys24 | Int | The unique number of buys in the past 24 hours. |
| uniqueSells1 | Int | The unique number of sells in the past hour. |
| uniqueSells4 | Int | The unique number of sells in the past 4 hours. |
| uniqueSells12 | Int | The unique number of sells in the past 12 hours. |
| uniqueSells24 | Int | The unique number of sells in the past 24 hours. |
| volume | String! | The volume over the time frame requested in USD. |
Ask questions, share what you're working on and request new features 👬👭