Search Coins

Search for coins using keywords and advanced filtering options

GET /coins/search

Search Coins

cURL

curl --request GET \
  --url https://frontend-api-v3.pump.fun/coins/search

200

{
  "data": [
    {
      "mint": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "description": "<string>",
      "image_uri": "<string>",
      "metadata_uri": "<string>",
      "twitter": "<string>",
      "telegram": "<string>",
      "creator": "<string>",
      "created_timestamp": 123,
      "complete": true,
      "market_cap": 123,
      "usd_market_cap": 123,
      "reply_count": 123,
      "last_reply": 123,
      "nsfw": true,
      "username": "<string>",
      "profile_image": "<string>"
    }
  ],
  "total": 123
}

Endpoint

GET https://frontend-api-v3.pump.fun/coins/search

Authentication

This endpoint requires JWT authentication. Include your token in the Authorization header.

Authorization: Bearer <your_token>

Query Parameters

searchTerm · string · required

The search term to query (searches name, symbol, and description)

limit · number · required

Maximum number of results to return (e.g., 10, 20, 50)

offset · number · required

Number of results to skip for pagination (e.g., 0, 10, 20)

sort · 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

order · string · required

Sort order. Options:

• ASC - Ascending order
• DESC - Descending order

includeNsfw · boolean · required

Whether to include NSFW (Not Safe For Work) content in results

creator · string · required

Filter by creator wallet address (leave empty to include all)

complete · boolean · required

Filter by completion status:

• true - Only show graduated coins
• false - Only show active coins
• Leave empty to show all

meta · string · required

Filter by meta category/tag (leave empty for no filter)

type · string · required

Filter by coin type (leave empty for all types)

Response

data · array

Array of coin objects matching the search criteria

Show Coin Object Properties

mint · string

The Solana mint address of the coin

name · string

The name of the coin

symbol · string

The ticker symbol of the coin

description · string

Description of the coin

image_uri · string

URL to the coin’s image

metadata_uri · string

URL to the coin’s metadata JSON

twitter · string

Twitter handle associated with the coin

telegram · string

Telegram link associated with the coin

creator · string

Wallet address of the coin creator

created_timestamp · number

Unix timestamp of when the coin was created

complete · boolean

Whether the coin has completed its bonding curve

market_cap · number

Current market capitalization in SOL

usd_market_cap · number

Market cap in USD

reply_count · number

Number of comments on the coin

last_reply · number

Timestamp of the last comment

nsfw · boolean

Whether the coin is marked as NSFW

username · string

Username of the creator

profile_image · string

Profile image URL of the creator

total · number

Total number of coins matching the search criteria (for pagination)

Code Examples

cURL

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"

Response Example

{
  "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

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

Common Use Cases

Find New Launches

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

?searchTerm=&sort=created_timestamp&order=DESC&limit=20&offset=0

Find Top Coins

Search by market cap to find the most valuable coins:

?searchTerm=&sort=market_cap&order=DESC&limit=20&offset=0

Search by Creator

Find all coins created by a specific wallet:

?searchTerm=&creator=CkqW...&sort=created_timestamp&order=DESC

Find Graduated Coins

Search for coins that have completed their bonding curve:

?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 - Get details for a specific coin from search results
• List Coins - Simple coin listing without search
• Get Metadata - Get metadata for searched coins