{"uid":"cap_LXpPsSyfYpotSjcgoNC6B","slug":"api-slamai-dev-edcde4ae","name":"SLAMai Trending Tokens","description":"Returns trending tokens across the entire blockchain for a specified activity window and optional category.\nThe size of the increase in active wallets over the activity window determines the token's trending rank.","url":"https://api.slamai.dev/chain/tokens/trending","method":"POST","headers":{},"bodySchema":{"type":"object","required":["blockchain"],"properties":{"num":{"type":"integer","description":"The maximum number of tokens to return. Maximum: 250."},"category":{"type":"string","description":"Filters to a specific subset of tokens. Currently only 'virtuals' is supported on Base."},"blockchain":{"type":"string","description":"The blockchain name."},"estimate_cost":{"type":"boolean","description":"When true, returns only the SLAM token cost estimation."},"activity_window":{"type":"string","description":"The length of time over which activity is measured."}}},"responseSchema":{"status":200,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"utc":{"type":"string","description":"The UTC timestamp of the block used for the response (ISO 8601 format)"},"slam":{"type":"number","format":"double","description":"The SLAM token cost for this API call"},"block":{"type":"integer","format":"int32","description":"The block number at which this data snapshot was generated"},"chain":{"type":"string","description":"The name of the blockchain network (e.g., 'base')"},"tokens":{"type":"array","items":{"type":"object","properties":{"fdv":{"type":"number","format":"double","description":"The token’s fully diluted valuation in USD"},"usd":{"type":"object","properties":{"cur":{"type":"number","format":"double","description":"The current token price in USD"},"prev":{"type":"array","items":{"type":"object","properties":{"change":{"type":"string","description":"Price change percentage."},"minutes":{"type":"integer","format":"int32","description":"Lookback period in minutes."}}},"description":"Previous price data for comparison"}}},"name":{"type":"string","description":"The full name of the token"},"rank":{"type":"integer","format":"int32","description":"The token’s trending rank, determined by change in active wallets."},"symbol":{"type":"string","description":"The token’s symbol (e.g., 'SLAM')"},"address":{"type":"string","description":"The token contract address"},"liquidity":{"type":"number","format":"double","description":"The liquidity value for the token in USD"},"first_minted":{"type":"object","properties":{"utc":{"type":"string","description":"The UTC timestamp of the mint (ISO 8601 format)"},"hash":{"type":"string","description":"The transaction hash of the first mint"},"block":{"type":"integer","format":"int32","description":"The block number of the first mint"}}}}},"description":"List of trending tokens for the specified activity window and category"}}},{"type":"object","properties":{"slam":{"type":"number","format":"double"}}}]}}},"description":"OK"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_GGJnUfAXqFaSzOQ860-1i","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 trending tokens across the blockchain ranked by growth in active wallets over a specified activity window, with optional category filtering.","exampleAgentPrompt":"What tokens are trending on-chain over the last 24 hours? Show me the top results in the DeFi category, ranked by growth in active wallets.","exampleUseCases":null,"resultDescription":"A ranked list of trending tokens on the blockchain, ordered by the size of increase in active wallets during the specified activity window. Each entry includes token identifiers and ranking signal derived from wallet activity growth, optionally filtered by category.","failureModes":["Invalid or unsupported activity window value returns an error","Invalid category filter returns empty results or error","Payment failure (x402) returns 402 status if USDC payment is not processed","Missing required fields in POST body returns 400 bad request","Network or service unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need to identify which tokens are gaining momentum across the blockchain as measured by wallet activity growth — ideal for discovering emerging trends, hot new tokens, or category-specific surges. Prefer this over price-based trending endpoints when you want social/adoption signal rather than purely price-driven ranking.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:39:39.855Z","isFirstParty":false}