get_pumpfun_graduates_by_trading_volume
Retrieve and analyze Pump.fun tokens with the highest trading volume in the last 24 hours. Returns a formatted table with volume rank, token details, and graduation time for informed Solana memecoin tracking.
Instructions
Retrieve Pump.fun token launches sorted by highest trading volume in the last 24 hours.
Args:
limit (int): Maximum number of tokens to return. Defaults to 100.
Returns:
str: A formatted table of Pump.fun graduates including volume rank, token name,
mint address, trading volume, and graduation time, or an error message if the query fails.
Raises:
httpx.HTTPStatusError: If the Dune API request fails.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No |
Implementation Reference
- main.py:128-157 (handler)The main handler function for the tool, decorated with @mcp.tool(). Fetches data from Dune Analytics query 4832613, processes it using helper functions strip_a_tag and get_latest_result, formats a markdown table using tabulate, and returns the result as a string.@mcp.tool() def get_pumpfun_graduates_by_trading_volume(limit: int = 100) -> str: """Retrieve Pump.fun token launches sorted by highest trading volume in the last 24 hours. Args: limit (int): Maximum number of tokens to return. Defaults to 100. Returns: str: A formatted table of Pump.fun graduates including volume rank, token name, mint address, trading volume, and graduation time, or an error message if the query fails. Raises: httpx.HTTPStatusError: If the Dune API request fails. """ try: data = get_latest_result(4832613, limit=limit) rows = [ [ row["volume_rank"], strip_a_tag(row["asset_with_chart"]), strip_a_tag(row["token_address_with_chart"]), f'${row["total_volume"]:.2f}', row["graduation_time"] ] for row in data ] headers = ["Rank", "Token", "Mint Address", "Volume(12h)", "Graduation Time"] return f"# Top {limit} Pump.fun Graduates by Trading Volume - Last 24 Hours\n\n" + tabulate(rows, headers=headers) except Exception as e: return str(e)
- main.py:23-46 (helper)Helper function used by the tool to fetch the latest execution results from a specified Dune Analytics query ID via the Dune API.def get_latest_result(query_id: int, limit: int = 1000): """ Fetch the latest results from a Dune Analytics query. Args: query_id (int): The ID of the Dune query to fetch results from. limit (int, optional): Maximum number of rows to return. Defaults to 1000. Returns: list: A list of dictionaries containing the query results, or an empty list if the request fails. Raises: httpx.HTTPStatusError: If the API request fails due to a client or server error. """ url = f"{BASE_URL}/query/{query_id}/results" params = {"limit": limit} with httpx.Client() as client: response = client.get(url, params=params, headers=HEADERS, timeout=300) response.raise_for_status() data = response.json() result_data = data.get("result", {}).get("rows", []) return result_data
- main.py:47-49 (helper)Helper function used by the tool to extract plain text from HTML anchor tags (e.g., token names and addresses).def strip_a_tag(html): match = re.search(r'>(.*?)</a>', html) return match.group(1) if match else html
- main.py:128-128 (registration)The @mcp.tool() decorator registers the function as an MCP tool.@mcp.tool()
- main.py:129-141 (schema)Type hints and docstring defining the input schema (limit: int = 100) and output (str).def get_pumpfun_graduates_by_trading_volume(limit: int = 100) -> str: """Retrieve Pump.fun token launches sorted by highest trading volume in the last 24 hours. Args: limit (int): Maximum number of tokens to return. Defaults to 100. Returns: str: A formatted table of Pump.fun graduates including volume rank, token name, mint address, trading volume, and graduation time, or an error message if the query fails. Raises: httpx.HTTPStatusError: If the Dune API request fails. """