Query recently graduated Pump.fun tokens on Solana with prices and market caps via x402 micropayment.
What it does
This x402-enabled endpoint returns data on tokens that have recently "graduated" on Pump.fun — meaning they crossed a market cap threshold indicating traction and liquidity on Solana. The endpoint is hosted on Heurist Mesh (mesh.heurist.xyz) and is part of the PumpFunTokenAgent.
Callers send a POST request with an optional `timeframe` parameter (in hours, default 24) to control how far back to look for graduated tokens. The response includes token details along with their latest prices and market caps. Payment is handled via the x402 protocol on the Base network using USDC (asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), with a maximum cost of 10,000 units (likely 0.01 USDC given 6-decimal USDC). The endpoint supports a maximum timeout of 120 seconds.
Documentation beyond the x402 challenge itself is sparse — the /docs, /api, /pricing, and /README paths on mesh.heurist.xyz all return 404. The input schema is well-defined in the challenge payload, but no output schema or example response is provided, so the exact shape of returned token data must be inferred from the endpoint description.
Capabilities
Use cases
- —Monitor newly graduated Pump.fun tokens to identify trending Solana meme coins
- —Build dashboards showing recently graduated tokens with their prices and market caps
- —Feed graduated token data into trading bots or alert systems
- —Research Solana token launches that have achieved meaningful liquidity
Fit
Best for
- —Agents or bots tracking Solana meme coin launches on Pump.fun
- —Developers building crypto dashboards that need graduated token feeds
- —Automated trading systems that react to token graduation events
Not for
- —Historical token data beyond the configurable timeframe window
- —Non-Solana token tracking or cross-chain analytics
- —Detailed on-chain transaction or holder analysis
Quick start
curl -X POST https://mesh.heurist.xyz/x402/agents/PumpFunTokenAgent/query_latest_graduated_tokens \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"timeframe": 24, "debug": false}'Example
Request
{
"debug": false,
"timeframe": 24
}Endpoint
Quality
The endpoint is live and returns a valid x402 challenge with a well-defined input schema. However, no output schema, example responses, or external documentation are available — /docs, /api, /pricing, and /README all 404. The response format must be inferred entirely from the endpoint description.
Warnings
- —No output schema provided — the structure of the returned token data is unknown.
- —All documentation paths (/docs, /api, /pricing, /README) return 404 on mesh.heurist.xyz.
- —No example response available; consumers must discover the response shape empirically.
- —Pricing unit interpretation is uncertain: maxAmountRequired is 10000 in raw USDC units (likely 0.01 USDC with 6 decimals), but this is inferred.
Citations
- —Endpoint is live and returns a 402 x402 challenge on POSThttps://mesh.heurist.xyz/x402/agents/PumpFunTokenAgent/query_latest_graduated_tokens
- —Payment is on Base network using USDC (asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) with maxAmountRequired of 10000https://mesh.heurist.xyz/x402/agents/PumpFunTokenAgent/query_latest_graduated_tokens
- —Input accepts timeframe (number, hours, default 24) and debug (boolean, default false) as body fieldshttps://mesh.heurist.xyz/x402/agents/PumpFunTokenAgent/query_latest_graduated_tokens
- —Maximum timeout is 120 secondshttps://mesh.heurist.xyz/x402/agents/PumpFunTokenAgent/query_latest_graduated_tokens
- —Root of mesh.heurist.xyz returns status okhttps://mesh.heurist.xyz