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

> Search for coins by mint address or other identifiers

## Overview

The Search endpoint enables searching for coins using various identifiers, primarily mint addresses. This endpoint provides quick lookup functionality for coin data.

## Authentication

This endpoint requires JWT authentication via the `Authorization` header:

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

## Endpoint

```http theme={null}
GET https://advanced-api-v2.pump.fun/search
```

## Query Parameters

<ParamField query="mint" type="string" required>
  The mint address to search for
</ParamField>

## Response

<ResponseField name="found" type="boolean">
  Whether a matching coin was found
</ResponseField>

<ResponseField name="coin" type="object">
  Coin object with detailed information (if found)

  <Expandable title="Coin Object">
    <ResponseField name="mint" type="string">
      The unique 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="imageUri" type="string">
      URL to the coin's image
    </ResponseField>

    <ResponseField name="metadataUri" type="string">
      URI to the coin's metadata
    </ResponseField>

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

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

    <ResponseField name="bondingCurve" type="object">
      Bonding curve information

      <Expandable title="Bonding Curve">
        <ResponseField name="progress" type="number">
          Percentage progress toward graduation (0-100)
        </ResponseField>

        <ResponseField name="marketCap" type="string">
          Current market capitalization
        </ResponseField>

        <ResponseField name="graduated" type="boolean">
          Whether the coin has graduated to Raydium
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://advanced-api-v2.pump.fun/search?mint=7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr" \
    -H "Authorization: Bearer <your_token>" \
    -H "Accept: application/json"
  ```

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

  url = "https://advanced-api-v2.pump.fun/search"
  params = {
      "mint": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
  }
  headers = {
      "Authorization": "Bearer <your_token>",
      "Accept": "application/json"
  }

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

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    mint: '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr'
  });

  fetch(`https://advanced-api-v2.pump.fun/search?${params}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer <your_token>',
      'Accept': 'application/json'
    }
  })
  .then(response => response.json())
  .then(data => console.log(data));
  ```

  ```typescript TypeScript theme={null}
  const params = new URLSearchParams({
    mint: '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr'
  });

  const response = await fetch(
    `https://advanced-api-v2.pump.fun/search?${params}`,
    {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer <your_token>',
        'Accept': 'application/json'
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

## Use Cases

* Implement coin search functionality
* Validate mint addresses
* Quick lookup of coin information
* Build autocomplete search features
* Verify coin existence before operations

## Notes

* Replace `<your_token>` with your actual JWT token
* The mint parameter must be a valid Solana address
* Returns `found: false` if no matching coin exists
* Use this endpoint to verify coins before displaying detailed information