Search Coins

GET

coins

Search Coins

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://frontend-api-v3.pump.fun/coins/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://frontend-api-v3.pump.fun/coins/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://frontend-api-v3.pump.fun/coins/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

string

required

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

number

required

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

number

required

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

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

string

required

Sort order. Options:

ASC - Ascending order
DESC - Descending order

boolean

required

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

string

required

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

boolean

required

Filter by completion status:

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

string

required

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

string

required

Filter by coin type (leave empty for all types)

Response

array

Array of coin objects matching the search criteria

Show Coin Object Properties

string

The Solana mint address of the coin

string

The name of the coin

string

The ticker symbol of the coin

string

Description of the coin

string

URL to the coin’s image

string

URL to the coin’s metadata JSON

string

Twitter handle associated with the coin

string

Telegram link associated with the coin

string

Wallet address of the coin creator

number

Unix timestamp of when the coin was created

boolean

Whether the coin has completed its bonding curve

number

Current market capitalization in SOL

number

Market cap in USD

number

Number of comments on the coin

number

Timestamp of the last comment

boolean

Whether the coin is marked as NSFW

string

Username of the creator

string

Profile image URL of the creator

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"

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())

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));

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:

Broad to Narrow: Start with general terms, then add filters
Use Sorting: Sort by market_cap to find established coins or created_timestamp for new launches
Pagination: Use limit and offset to implement infinite scroll or pagination
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

⌘I

Search Coins

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://frontend-api-v3.pump.fun/coins/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://frontend-api-v3.pump.fun/coins/search"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://frontend-api-v3.pump.fun/coins/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

Coins

Trades

Users & Authentication

Social Features

Livestreams

Moderation

Advanced Analytics

Utilities

Endpoint

Authentication

Query Parameters

Response

Code Examples

Response Example

Search Tips

Common Use Cases

Find New Launches

Find Top Coins

Search by Creator

Find Graduated Coins

Notes

​Endpoint

​Authentication

​Query Parameters

​Response

​Code Examples

​Response Example

​Search Tips

​Common Use Cases

​Find New Launches

​Find Top Coins

​Search by Creator

​Find Graduated Coins

​Notes

​Related Endpoints

Endpoint

Authentication

Query Parameters

Response

Code Examples

Response Example

Search Tips

Common Use Cases

Find New Launches

Find Top Coins

Search by Creator

Find Graduated Coins

Notes

Related Endpoints