{"uid":"cap_0zS9im428tX7F6Fc9Wqj1","slug":"x4o2-stonkfun-trending-tokens-by-volume-or-market-cap-3bb70522","name":"x4o2 StonkFun Trending Tokens by Volume or Market Cap","description":"24h observed swap volume or fresh market cap within one quote mint","url":"https://stonk.x4o2.com/v1/trending?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":[],"properties":{}},"queryParams":{"type":"object","required":[],"properties":{"sort":{"enum":["volume","mcap"],"type":"string","default":"volume","description":"Ranking metric"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Page size"},"quoteMint":{"type":"string","description":"Exact quote mint; required for ranking or candles"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"data":{"type":["object","null"],"properties":{"sort":{"type":["string","null"]},"items":{"type":["array","null"]},"limit":{"type":["number","null"]},"partial":{"type":["boolean","null"]},"quoteMint":{"type":["string","null"]},"windowSeconds":{"type":["number","null"]}}},"meta":{"type":["object","null"],"properties":{"ageMs":{"type":["number","null"]},"source":{"type":["string","null"]},"partial":{"type":["boolean","null"]},"commitment":{"type":["string","null"]},"observedAt":{"type":["number","null"]},"discoveryAt":{"type":["string","null"]},"freshnessSeconds":{"type":["number","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RoeC6c6YV999IBLuxi_Ru","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of SPL tokens trending by 24h swap volume or market cap within a specified quote mint on the Stonk platform","exampleAgentPrompt":"Pull the top 20 trending tokens on Stonk sorted by 24h swap volume for the SOL quote mint and show me which ones are gaining the most traction right now.","exampleUseCases":[{"title":"Discover hot tokens by trading volume","prompt":"Show me the top 10 SPL tokens trending by swap volume right now on the Stonk platform for the USDC quote mint — I want to see what's getting the most on-chain action."},{"title":"Market cap ranking for token research","prompt":"Get me up to 50 tokens ranked by market cap within the SOL quote mint on Stonk so I can find the biggest projects and do some research."},{"title":"Automated trend monitoring for trading bot","prompt":"Every 5 minutes, check the top 20 trending tokens on Stonk sorted by volume for a given quote mint and alert me when a new token breaks into the top 5."}],"resultDescription":"Returns a paginated list of trending SPL tokens ranked by either 24h observed swap volume or market cap within a specified quote mint. Each item includes token identifiers, ranking metric values, and metadata such as observation timestamp, data age in milliseconds, source, freshness in seconds, and whether the result set is partial.","failureModes":["Missing or invalid quoteMint returns empty or error response","Invalid sort enum value (not 'volume' or 'mcap') causes validation failure","limit exceeding 100 is rejected","Partial data flag set to true when on-chain indexing is incomplete","Stale data returned if the indexer has not recently observed swaps","Rate limit or payment failure returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a real-time ranked leaderboard of SPL tokens by trading activity or market cap within a specific quote mint on the Stonk platform. It is the right choice for trend discovery, token screening, or building dashboards that surface the most active or largest on-chain tokens. Prefer this over raw pool or mint endpoints when you want pre-sorted aggregated metrics rather than individual token or pool details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:03.109Z","isFirstParty":false,"canonicalSlug":"x4o2-stonkfun-trending-tokens-by-volume-or-market-cap-3bb70522"}