Skip to main content
GET
/
coins
/
search
Search Coins
curl --request GET \
  --url https://frontend-api-v3.pump.fun/coins/search
{
  "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
​
total
number
Total number of coins matching the search criteria (for pagination)

​
Code Examples

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

Build docs developers (and LLMs) love

Get started for freeTalk to us