> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/BankkRoll/pumpfun-apis/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Coins

> Search for coins using keywords and advanced filtering options

## Endpoint

```http theme={null}
GET https://frontend-api-v3.pump.fun/coins/search
```

## Authentication

<Note>
  This endpoint requires JWT authentication. Include your token in the Authorization header.
</Note>

```bash theme={null}
Authorization: Bearer <your_token>
```

## Query Parameters

<ParamField query="searchTerm" type="string" required>
  The search term to query (searches name, symbol, and description)
</ParamField>

<ParamField query="limit" type="number" required>
  Maximum number of results to return (e.g., 10, 20, 50)
</ParamField>

<ParamField query="offset" type="number" required>
  Number of results to skip for pagination (e.g., 0, 10, 20)
</ParamField>

<ParamField query="sort" type="string" required>
  Field to sort results by. Options:

  * `created_timestamp` - Sort by creation date
  * `market_cap` - Sort by market capitalization
  * `last_reply` - Sort by last activity
  * `reply_count` - Sort by number of comments
</ParamField>

<ParamField query="order" type="string" required>
  Sort order. Options:

  * `ASC` - Ascending order
  * `DESC` - Descending order
</ParamField>

<ParamField query="includeNsfw" type="boolean" required>
  Whether to include NSFW (Not Safe For Work) content in results
</ParamField>

<ParamField query="creator" type="string" required>
  Filter by creator wallet address (leave empty to include all)
</ParamField>

<ParamField query="complete" type="boolean" required>
  Filter by completion status:

  * `true` - Only show graduated coins
  * `false` - Only show active coins
  * Leave empty to show all
</ParamField>

<ParamField query="meta" type="string" required>
  Filter by meta category/tag (leave empty for no filter)
</ParamField>

<ParamField query="type" type="string" required>
  Filter by coin type (leave empty for all types)
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of coin objects matching the search criteria

  <Expandable title="Coin Object Properties">
    <ResponseField name="mint" type="string">
      The Solana mint address of the coin
    </ResponseField>

    <ResponseField name="name" type="string">
      The name of the coin
    </ResponseField>

    <ResponseField name="symbol" type="string">
      The ticker symbol of the coin
    </ResponseField>

    <ResponseField name="description" type="string">
      Description of the coin
    </ResponseField>

    <ResponseField name="image_uri" type="string">
      URL to the coin's image
    </ResponseField>

    <ResponseField name="metadata_uri" type="string">
      URL to the coin's metadata JSON
    </ResponseField>

    <ResponseField name="twitter" type="string">
      Twitter handle associated with the coin
    </ResponseField>

    <ResponseField name="telegram" type="string">
      Telegram link associated with the coin
    </ResponseField>

    <ResponseField name="creator" type="string">
      Wallet address of the coin creator
    </ResponseField>

    <ResponseField name="created_timestamp" type="number">
      Unix timestamp of when the coin was created
    </ResponseField>

    <ResponseField name="complete" type="boolean">
      Whether the coin has completed its bonding curve
    </ResponseField>

    <ResponseField name="market_cap" type="number">
      Current market capitalization in SOL
    </ResponseField>

    <ResponseField name="usd_market_cap" type="number">
      Market cap in USD
    </ResponseField>

    <ResponseField name="reply_count" type="number">
      Number of comments on the coin
    </ResponseField>

    <ResponseField name="last_reply" type="number">
      Timestamp of the last comment
    </ResponseField>

    <ResponseField name="nsfw" type="boolean">
      Whether the coin is marked as NSFW
    </ResponseField>

    <ResponseField name="username" type="string">
      Username of the creator
    </ResponseField>

    <ResponseField name="profile_image" type="string">
      Profile image URL of the creator
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total number of coins matching the search criteria (for pagination)
</ResponseField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://frontend-api-v3.pump.fun/coins/search?searchTerm=pepe&limit=10&offset=0&sort=market_cap&order=DESC&includeNsfw=false&creator=&complete=&meta=&type=" \
    -H "Authorization: Bearer <your_token>" \
    -H "Accept: application/json"
  ```

  ```python Python theme={null}
  import requests

  url = "https://frontend-api-v3.pump.fun/coins/search"
  headers = {
      "Authorization": "Bearer <your_token>",
      "Accept": "application/json"
  }

  params = {
      "searchTerm": "pepe",
      "limit": 10,
      "offset": 0,
      "sort": "market_cap",
      "order": "DESC",
      "includeNsfw": False,
      "creator": "",
      "complete": "",
      "meta": "",
      "type": ""
  }

  response = requests.get(url, params=params, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const axios = require('axios');

  const url = 'https://frontend-api-v3.pump.fun/coins/search';
  const headers = {
    'Authorization': 'Bearer <your_token>',
    'Accept': 'application/json'
  };

  const params = {
    searchTerm: 'pepe',
    limit: 10,
    offset: 0,
    sort: 'market_cap',
    order: 'DESC',
    includeNsfw: false,
    creator: '',
    complete: '',
    meta: '',
    type: ''
  };

  axios.get(url, { headers, params })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "data": [
    {
      "mint": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
      "name": "Pepe Coin",
      "symbol": "PEPE",
      "description": "The official Pepe meme coin",
      "image_uri": "https://cf-ipfs.com/ipfs/...",
      "metadata_uri": "https://cf-ipfs.com/ipfs/...",
      "twitter": "@pepecoin",
      "telegram": "https://t.me/pepecoin",
      "creator": "CkqW...",
      "created_timestamp": 1704067200000,
      "complete": false,
      "market_cap": 125.5,
      "usd_market_cap": 14056.25,
      "reply_count": 256,
      "last_reply": 1704153600000,
      "nsfw": false,
      "username": "pepelover",
      "profile_image": "https://..."
    }
  ],
  "total": 1
}
```

## Search Tips

<Tip>
  **Effective Search Strategies:**

  1. **Broad to Narrow**: Start with general terms, then add filters
  2. **Use Sorting**: Sort by `market_cap` to find established coins or `created_timestamp` for new launches
  3. **Pagination**: Use `limit` and `offset` to implement infinite scroll or pagination
  4. **Creator Filter**: Search for coins by a specific creator using their wallet address
</Tip>

## Common Use Cases

### Find New Launches

Search with `sort=created_timestamp` and `order=DESC` to find the newest coins:

```bash theme={null}
?searchTerm=&sort=created_timestamp&order=DESC&limit=20&offset=0
```

### Find Top Coins

Search by market cap to find the most valuable coins:

```bash theme={null}
?searchTerm=&sort=market_cap&order=DESC&limit=20&offset=0
```

### Search by Creator

Find all coins created by a specific wallet:

```bash theme={null}
?searchTerm=&creator=CkqW...&sort=created_timestamp&order=DESC
```

### Find Graduated Coins

Search for coins that have completed their bonding curve:

```bash theme={null}
?searchTerm=&complete=true&sort=market_cap&order=DESC
```

## Notes

* All query parameters are required, but can be empty strings for filters you don't want to apply
* The `searchTerm` parameter searches across name, symbol, and description fields
* Empty `searchTerm` returns all coins matching other filters
* Replace `<your_token>` with your actual JWT token
* Use pagination (`limit` and `offset`) for large result sets

## Related Endpoints

* [Get Coin](/api-reference/coins/get-coin) - Get details for a specific coin from search results
* [List Coins](/api-reference/coins/list-coins) - Simple coin listing without search
* [Get Metadata](/api-reference/coins/metadata) - Get metadata for searched coins