> ## 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.

# How to Use Universal Fast Search Across Ethereum, Solana, BNB, Base & More

> Use the Fast Search endpoint to search tokens by typing an input string like a symbol or name, with optional filtering and sorting across chains.

The [**Fast Search**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.

You can also filter and sort results using optional parameters.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/KdNQ0RUvEJI" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## 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"`)
* Search by EVM address prefix for autocomplete flows (example: `0x0e09`)

***

## 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](https://admin.mobula.io/)

Optional:

* DexScreener (to pick real token symbols to test)

***

## When to use Fast Search

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**](https://docs.mobula.io/rest-api-reference/endpoint/asset-details)

If you want enriched details for a specific token contract, use: [**Token Details**](https://docs.mobula.io/rest-api-reference/endpoint/token-details)

If you want to list pools and markets for a token across DEXes, use: [**Token Markets**](https://docs.mobula.io/rest-api-reference/endpoint/token-markets)

If you want market-level pool stats like liquidity, volume, and price changes, use: [**Market Details**](https://docs.mobula.io/rest-api-reference/endpoint/market-details)

***

## Walkthrough to Get Fast Search

### 1. Prepare your query

The Fast Search endpoint requires one parameter:

| Parameter | Description                                                    |
| --------- | -------------------------------------------------------------- |
| `input`   | Search query string (example: `eth`, `parti`, `"W"`, `0x0e09`) |

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`.

Tip: If the input starts with an EVM address prefix like `0x0e09`, Fast Search matches token contract addresses, pool addresses, and deployer addresses that start with that prefix.

### 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.
* **Address prefix match**: Start the input with an EVM prefix such as `0x0e09` to find matching token, pool, or deployer addresses.
* **Output size**: Use `limit` to control how many results are returned (up to 20).

***

## Summary

The [**Fast Search**](https://docs.mobula.io/rest-api-reference/endpoint/fast-search) endpoint helps you:

* Search tokens using an input string like a symbol or name
* Search by EVM address prefix for contract autocomplete
* 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](https://admin.mobula.io/)