Example
Usage Guidelines
- Response limit: 200 tokens per request
- Use
trendingScore24orvolume24rankings for better results instead ofcreatedAt - Apply quality filters such as volume and liquidity minimums to avoid low quality tokens
- Use
phraseparameter for searching by token name, symbol, or contract address - For exact symbol searches, use the
$prefix and combinephrasewith volume/liquidity rankings to improve results
Troubleshooting Tips
How can we use potentialScam to remove scams from results?
How can we use potentialScam to remove scams from results?
We actually remove potential scam tokens automatically without this filter. If you set
potentialScamto true, your results will show all (potentially) scam tokens that we have flagged. If set to false, it will return similar results as without the filter, however, all majors and stables will be included now. While false positives can occur, our detection system significantly reduces exposure to scam tokens.We also allow users to flag scams on our frontend at Defined.fi (moderated daily) which will update our API.Token not being returned in search results
Token not being returned in search results
Check if the token has been flagged as a potential scam by adding
includeScams: true to your filters. Also verify you’re searching the correct network and the token has trading activity (we only index tokens after swaps have occurred).Results are returning too much junk data or scam tokens
Results are returning too much junk data or scam tokens
Add quality filters to improve results. We recommend setting minimum thresholds for volume, liquidity, holders, etc. Additionally, rank results by
trendingScore24 or volume24 rather than liquidity to get more meaningful results. Experiment with filters that will suit your needs.Responses seem slow. What is the expected response time for queries and how long does it take for new tokens to be queryable?
Responses seem slow. What is the expected response time for queries and how long does it take for new tokens to be queryable?
Response times are generally 60-150ms and it takes ~2-5 seconds to update the search cluster with new data. Contact our team if you are experiencing consistently delayed response times.
How can I create trending pages similar to those on Defined.fi?
How can I create trending pages similar to those on Defined.fi?
Check out our Discover Tokens recipe for more useful tips on how to use
filterTokens.Returns: TokenFilterConnection
Arguments
A set of filters to apply.
The type of statistics returned. Can be
FILTERED or UNFILTEREDA phrase to search for. Can match a token contract address or partially match a token’s name or symbol.
A list of token IDs (
address:networkId) or addresses. Can be left blank to discover new tokens.A list of token IDs (
address:networkId) to exclude from resultsA list of ranking attributes to apply.
The maximum number of tokens to return.
Where in the list the server should start when returning items. Use
count+page from the previous query to request the next page of results.