Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

The Fast Search endpoint lets you search tokens by typing an input string like a symbol or name. It helps you quickly find token information and relevant results across chains like Solana, Ethereum, BNB Chain, Base, and more. You can also filter and sort results using optional parameters.

​
What this endpoint does

With this API, you can:
  • Perform a universal search using an input string
  • Return results such as token pricing information, holders data, and metadata depending on the result type
  • Filter results to specific chains using filters (JSON)
  • Sort results using sortBy and control output size with limit
  • Use exact symbol match by wrapping the input in double quotes (example: "W")

​
What you’ll need

  • Basic knowledge of REST APIs
  • A token symbol or name to search (example: eth, parti)
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener (to pick real token symbols to test)
Use this endpoint when you want to:
  • Search tokens quickly by symbol or name
  • Build a search bar for tokens, assets, or pairs
  • Restrict results to specific chains like Ethereum, Base, Arbitrum, or Solana
  • Sort results by metrics like volume24h or marketCap
  • Use exact match search for short symbols to reduce noisy results
If you want a full asset snapshot after selecting a result, use: Asset Details If you want enriched details for a specific token contract, use: Token Details If you want to list pools and markets for a token across DEXes, use: Token Markets If you want market-level pool stats like liquidity, volume, and price changes, use: Market Details

​
1. Prepare your query

The Fast Search endpoint requires one parameter:
ParameterDescription
inputSearch query string (example: eth, parti, "W")
Optional parameters you can use:
  • type: Type of results to return: tokens, assets, or pairs
  • filters: JSON string with filter options like blockchains (example: filters={"blockchains":"8453,1,42161,10,solana"})
  • sortBy: Sort field (example: volume24h, marketCap, searchScore, trendingScore24h)
  • limit: Maximum number of results (1 to 20, default: 5)
  • excludeBonded: Exclude bonded tokens from results
Tip: Wrap your input in double quotes to perform an exact symbol match. Example: "W" returns only tokens with symbol W, not WETH or WBTC.

​
2. Find a token to test with DexScreener

To get a real search term:
  • Open DexScreener
  • Pick a token
  • Copy the token symbol or name
This symbol is used as the input parameter.

​
3. Fill the API form

Either:
  • Enter an input string only, or
  • Enter input and set type, filters, sortBy, limit, or excludeBonded
Then click Send.

​
Reviewing the response

  • Search results list: The endpoint returns the top matches for your input query in data[].
  • Result type: Use type to control whether you get tokens, assets, or pairs.
  • Ranking: Results are ranked using searchScore by default. You can change ranking using sortBy (example: volume24h, marketCap).
  • Filters: Use filters to restrict results to specific chains by passing a JSON object or JSON string for blockchains.
  • Exact match: Wrap your input in double quotes to search for an exact symbol match, useful for short symbols.
  • Output size: Use limit to control how many results are returned (up to 20).

​
Summary

The Fast Search endpoint helps you:
  • Search tokens using an input string like a symbol or name
  • Filter results by chain using filters and sort by key metrics using sortBy
  • Use double quotes for exact symbol matches when needed
  • Control output size with limit

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here