{"uid":"cap_pBhtGUJ27kDkmt_ToqD7h","slug":"aiagentoracle-ai-6f6fc56a","name":"AgentOracle Top N Tokens by Market Cap","description":"AgentOracle: top N on-chain crypto tokens by market cap. Pass `limit` (1..100, default 20). Same per-token shape as /tokens — price, 24h volume, market cap, liquidity, 24h price change.","url":"https://aiagentoracle.ai/api/v1/tokens/top","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"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Number of top tokens to return."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["tokens","total","freshness"],"properties":{"total":{"type":"integer","minimum":0},"tokens":{"type":"array","items":{"type":"object","required":["id","symbol","name","chain","lastUpdated"],"properties":{"id":{"type":"integer","description":"Internal numeric identifier."},"name":{"type":"string"},"chain":{"type":"string","description":"EVM chain slug (e.g. base, ethereum, arbitrum)."},"symbol":{"type":"string","description":"Uppercase ticker symbol, e.g. ETH."},"imageUrl":{"type":["string","null"],"format":"uri"},"priceUsd":{"type":["number","null"],"description":"Spot price in USD."},"marketCap":{"type":["number","null"],"description":"Fully-diluted market cap in USD."},"volume24h":{"type":["number","null"],"description":"Trailing 24h trading volume in USD."},"lastUpdated":{"type":"string","format":"date-time"},"liquidityUsd":{"type":["number","null"],"description":"On-chain pool liquidity in USD."},"confidenceScore":{"type":["number","null"],"description":"Source-quality score, 0..1."},"priceChange24hPercent":{"type":["number","null"],"description":"24h price change, percent (-100..+inf)."}}}},"freshness":{"type":"string"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":20}}},"response":{"total":20,"tokens":[{"id":1,"name":"Bitcoin","chain":"multi","symbol":"BTC","imageUrl":"https://coin-images.coingecko.com/coins/images/1/large/bitcoin.png?1696501400","priceUsd":63896,"marketCap":1280588862284,"volume24h":32402238637,"lastUpdated":"2026-06-18T04:41:05.855Z","liquidityUsd":null,"confidenceScore":0.8,"priceChange24hPercent":-2.9584},{"id":2,"name":"Ethereum","chain":"multi","symbol":"ETH","imageUrl":"https://coin-images.coingecko.com/coins/images/279/large/ethereum.png?1696501628","priceUsd":1733.84,"marketCap":209207647736,"volume24h":13701708470,"lastUpdated":"2026-06-18T04:41:06.223Z","liquidityUsd":null,"confidenceScore":0.8,"priceChange24hPercent":-3.3285},{"id":3,"name":"Tether","chain":"multi","symbol":"USDT","imageUrl":"https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661","priceUsd":0.99895,"marketCap":186353608566,"volume24h":55569740283,"lastUpdated":"2026-06-18T04:41:06.305Z","liquidityUsd":null,"confidenceScore":0.8,"priceChange24hPercent":-0.0063},{"id":5,"name":"BNB","chain":"multi","symbol":"BNB","imageUrl":"https://coin-images.coingecko.com/coins/images/825/large/bnb-icon2_2x.png?1696501970","priceUsd":591.9,"marketCap":79765931019,"volume24h":951705557,"lastUpdated":"2026-06-18T04:41:06.517Z","liquidityUsd":140509526694.0705,"confidenceScore":0.9,"priceChange24hPercent":-2.5082},{"id":6,"name":"USDC","chain":"multi","symbol":"USDC","imageUrl":"https://coin-images.coingecko.com/coins/images/6319/large/USDC.png?1769615602","priceUsd":0.999722,"marketCap":74714373231,"volume24h":13872906208,"lastUpdated":"2026-06-18T04:41:06.469Z","liquidityUsd":null,"confidenceScore":0.8,"priceChange24hPercent":-0.0047},{"id":4,"name":"XRP","chain":"multi","symbol":"XRP","imageUrl":"https://coin-images.coingecko.com/coins/images/44/large/xrp-symbol-white-128.png?1696501442","priceUsd":1.17,"marketCap":72624550276,"volume24h":1942205487,"lastUpdated":"2026-06-18T04:41:06.551Z","liquidityUsd":null,"confidenceScore":0.8,"priceChange24hPercent":-3.8818},{"id":7,"name":"Solana","chain":"multi","symbol":"SOL","imageUrl":"https://coin-images.coingecko.com/coins/images/4128/large/solana.png?1718769756","priceUsd":71.09,"marketCap":41247172604,"volume24h":2703230713,"lastUpdated":"2026-06-18T04:41:06.632Z","liquidityUsd":null,"confidenceScore":0.8,"priceChange24hPercent":-3.567},{"id":8,"name":"TRON","chain":"multi","symbol":"TRX","imageUrl":"https://coin-images.coingecko.com/coins/images/1094/large/photo_2026-04-13_09-59-16.png?1776048311","priceUsd":0.319947,"marketCap":30341119064,"volume24h":629346933,"lastUpdated":"2026-06-18T04:41:06.712Z","liquidityUsd":null,"confidenceScore":0.75,"priceChange24hPercent":0.8565},{"id":9,"name":"Figure Heloc","chain":"multi","symbol":"FIGR_HELOC","imageUrl":"https://coin-images.coingecko.com/coins/images/68480/large/figure.png?1755863954","priceUsd":1.02,"marketCap":19323006866,"volume24h":54398606,"lastUpdated":"2026-06-18T04:41:06.803Z","liquidityUsd":null,"confidenceScore":0.7,"priceChange24hPercent":-1.4153},{"id":13,"name":"Hyperliquid","chain":"multi","symbol":"HYPE","imageUrl":"https://coin-images.coingecko.com/coins/images/50882/large/hyperliquid.jpg?1729431300","priceUsd":69.39,"marketCap":15433163157,"volume24h":1320792879,"lastUpdated":"2026-06-18T04:41:07.208Z","liquidityUsd":5946783222.342248,"confidenceScore":0.95,"priceChange24hPercent":-7.1459},{"id":10,"name":"Dogecoin","chain":"multi","symbol":"DOGE","imageUrl":"https://coin-images.coingecko.com/coins/images/5/large/dogecoin.png?1696501409","priceUsd":0.084613,"marketCap":13088790235,"volume24h":590437012,"lastUpdated":"2026-06-18T04:41:06.965Z","liquidityUsd":null,"confidenceScore":0.75,"priceChange24hPercent":-3.3843},{"id":12,"name":"USDS","chain":"multi","symbol":"USDS","imageUrl":"https://coin-images.coingecko.com/coins/images/39926/large/usds.webp?1726666683","priceUsd":0.999623,"marketCap":10262531776,"volume24h":109288444,"lastUpdated":"2026-06-18T04:41:07.046Z","liquidityUsd":null,"confidenceScore":0.75,"priceChange24hPercent":-0.0028},{"id":29,"name":"Rain","chain":"multi","symbol":"RAIN","imageUrl":"https://coin-images.coingecko.com/coins/images/69134/large/Rain_logo_1_.png?1762952191","priceUsd":0.01455243,"marketCap":9063614213,"volume24h":41923133,"lastUpdated":"2026-06-18T04:41:07.125Z","liquidityUsd":null,"confidenceScore":0.65,"priceChange24hPercent":2.9301},{"id":14,"name":"LEO Token","chain":"multi","symbol":"LEO","imageUrl":"https://coin-images.coingecko.com/coins/images/8418/large/leo-token.png?1696508607","priceUsd":9.71,"marketCap":8937997219,"volume24h":283568,"lastUpdated":"2026-06-18T04:41:07.209Z","liquidityUsd":null,"confidenceScore":0.6,"priceChange24hPercent":0.5507},{"id":19,"name":"Zcash","chain":"multi","symbol":"ZEC","imageUrl":"https://coin-images.coingecko.com/coins/images/486/large/circle-zcash-color.png?1696501740","priceUsd":468.93,"marketCap":7865271062,"volume24h":639238756,"lastUpdated":"2026-06-18T04:41:07.289Z","liquidityUsd":null,"confidenceScore":0.7,"priceChange24hPercent":-8.1932},{"id":22,"name":"Stellar","chain":"multi","symbol":"XLM","imageUrl":"https://coin-images.coingecko.com/coins/images/100/large/fmpFRHHQ_400x400.jpg?1735231350","priceUsd":0.231222,"marketCap":7812252944,"volume24h":625465367,"lastUpdated":"2026-06-18T04:41:07.370Z","liquidityUsd":null,"confidenceScore":0.7,"priceChange24hPercent":2.7386},{"id":21,"name":"Canton","chain":"multi","symbol":"CC","imageUrl":"https://coin-images.coingecko.com/coins/images/70468/large/Canton-Ticker_%281%29.png?1762826299","priceUsd":0.163991,"marketCap":6367014457,"volume24h":7852345,"lastUpdated":"2026-06-18T04:41:07.450Z","liquidityUsd":null,"confidenceScore":0.6,"priceChange24hPercent":1.8973},{"id":11,"name":"WhiteBIT Coin","chain":"multi","symbol":"WBT","imageUrl":"https://coin-images.coingecko.com/coins/images/27045/large/wbt_token.png?1696526096","priceUsd":52.79,"marketCap":6249486932,"volume24h":164523617,"lastUpdated":"2026-06-18T04:41:07.531Z","liquidityUsd":null,"confidenceScore":0.7,"priceChange24hPercent":-2.2531},{"id":18,"name":"Monero","chain":"multi","symbol":"XMR","imageUrl":"https://coin-images.coingecko.com/coins/images/69/large/monero_logo.png?1696501460","priceUsd":330.24,"marketCap":6196844817,"volume24h":144355786,"lastUpdated":"2026-06-18T04:41:07.681Z","liquidityUsd":null,"confidenceScore":0.7,"priceChange24hPercent":-5.0437},{"id":15,"name":"Cardano","chain":"multi","symbol":"ADA","imageUrl":"https://coin-images.coingecko.com/coins/images/975/large/cardano.png?1696502090","priceUsd":0.165622,"marketCap":6161746443,"volume24h":501599093,"lastUpdated":"2026-06-18T04:41:07.761Z","liquidityUsd":null,"confidenceScore":0.7,"priceChange24hPercent":-4.363}],"freshness":"2026-06-18T04:41:05.855Z"}},"exampleRequest":{"limit":20},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rnxK9Xjd3JZFHle7lpm3I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top N on-chain crypto tokens ranked by market cap, with price, volume, liquidity, and 24h change data.","exampleAgentPrompt":"Show me the top 50 on-chain crypto tokens by market cap from AgentOracle, including their price, 24h volume, liquidity, and price change percentage.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of up to 100 token records (id, symbol, name, chain, priceUsd, marketCap, volume24h, liquidityUsd, priceChange24hPercent, confidenceScore, lastUpdated), a total count, and a freshness timestamp indicating data recency.","failureModes":["limit out of range (< 1 or > 100) returns a validation error","payment not provided or insufficient USDC balance returns 402 Payment Required","service temporarily unavailable returns 503","empty result set if no tokens are tracked yet","stale data if ingestion pipeline is lagging (check freshness field)"],"whenToPreferThis":"Use this endpoint when you need a ranked leaderboard of on-chain tokens by market cap — ideal for portfolio overviews, market dashboards, DeFi research, or when you want to scan the top N tokens without specifying a particular symbol. Prefer this over the single-token lookup when you need a broad market snapshot rather than details on one specific token.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:33.968Z","isFirstParty":false}