{"uid":"cap_2BxpBocrWzJeOTZ63GKc5","slug":"agent402-coin-categories-list-c6f5b244","name":"Agent402 Coin Categories List","description":"Coin categories (Layer 1, Meme, AI, DeFi, Stablecoins, RWA, ...) ranked by market cap, with 24h market cap change %, 24h volume and the top-3 coins per category. Order by market_cap_desc (default), market_cap_asc, market_cap_change_24h_desc/asc, name_asc/desc; optional `query` substring filter on category name/id; limit 1-100 (default 25). The sector-rotation view: which narratives are gaining or bleeding today. Cached in-process for 5 minutes.","url":"https://agent402.tools/api/coin-categories","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":"number","description":"1-100 (default 25)."},"order":{"type":"string","description":"market_cap_desc (default), market_cap_asc, market_cap_change_24h_desc, market_cap_change_24h_asc, name_asc, name_desc."},"query":{"type":"string","description":"Optional case-insensitive substring filter on the category name or id (e.g. \"meme\", \"layer-2\")."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","fetchedAt","cached","order","count","totalCategories","categories"],"properties":{"count":{"type":"integer"},"order":{"type":"string"},"cached":{"type":"boolean"},"source":{"type":"string"},"fetchedAt":{"type":"string"},"categories":{"type":"array","items":{"type":"object"}},"totalCategories":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"order":"market_cap_desc","cached":false,"source":"coingecko","fetchedAt":"2026-08-22T13:20:00.000Z","categories":[{"id":"smart-contract-platform","name":"Smart Contract Platform","rank":1,"topCoins":["bitcoin","ethereum","solana"],"marketCap":2261471553524.96,"updatedAt":"2026-08-22T13:15:00.000Z","volume24h":95000000000,"marketCapChange24hPct":1.1784}],"totalCategories":400}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_upPiPJqphkaxZVdjoxS4I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 cryptocurrency coin categories (e.g. DeFi, Layer-2, Meme) with market cap, 24h volume, and top coins, sourced from CoinGecko.","exampleAgentPrompt":"Show me the top 10 crypto coin categories ranked by market cap descending, and filter for anything related to 'layer-2'.","exampleUseCases":[{"title":"Sector rotation research for crypto portfolio","prompt":"List the top 25 crypto categories ranked by market cap descending so I can see which blockchain sectors are dominating right now."},{"title":"Finding fast-moving meme coin categories","prompt":"Pull up crypto categories sorted by 24-hour market cap change descending and filter for anything with 'meme' in the name — I want to see which meme coin sectors are moving today."},{"title":"Building a category dropdown for a crypto dashboard","prompt":"Fetch up to 100 coin categories ordered alphabetically by name so I can populate a category filter in my dashboard."}],"resultDescription":"A JSON object containing: the count of returned categories, the applied sort order, cache status, source (CoinGecko), fetch timestamp, and an array of category objects each with id, name, rank, top coin ids, market cap in USD, 24h volume, 24h market cap change percentage, and last updated timestamp. Also includes a totalCategories field indicating the full universe of tracked categories.","failureModes":["Invalid 'order' enum value returns a validation error","limit outside 1-100 range may return an error or be clamped","query substring with no matches returns an empty categories array with count 0","Upstream CoinGecko outage may return a 502 or stale cached data","Payment failure (insufficient USDC) results in a 402 response before the call is processed"],"whenToPreferThis":"Choose this endpoint when you need a structured, ranked list of crypto market sectors or themes (DeFi, NFT, Layer-2, Meme, etc.) with associated market cap and volume data. It is ideal for building sector dashboards, screening for hot categories, or populating category filters in analytics tools. Prefer it over a raw CoinGecko integration when you want a pay-per-call, no-signup approach via x402 with USDC micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:51:31.279Z","isFirstParty":false}