{"uid":"cap_xl-HiRwg_9IjtbGWOxxsn","slug":"2s-fred-categories-lookup-8eefcfff","name":"2s FRED Categories Lookup","description":"Browse the Federal Reserve FRED category tree to DISCOVER economic series. Pass a categoryId to get that category (name + parent), its child categories, and the most-popular series filed under it (id, title, units, frequency) — then pull the data with econ.fred. Omit categoryId (or pass 0) for the eight top-level categories: Money/Banking/Finance, Population/Employment/Labor, National Accounts, Production & Business Activity, Prices, International Data, U.S. Regional Data, Academic Data. Walk down via each child's id. Free, public-domain (FRED). The structured map of what FRED actually contains — far more reliable than guessing series ids. Companion to econ.fred (fetch/search) and econ.fred-releases (calendar).","url":"https://2s.io/api/econ/fred-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","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"categoryId":{"type":"integer","description":"FRED category id (0 or omitted = top level)."},"seriesLimit":{"type":"integer","description":"Max series to list for the category (0-50, default 10; 0 = none)."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lUpzeVnrnQTS_zo4K1xpm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches FRED (Federal Reserve Economic Data) category hierarchy and series listings by category ID","exampleAgentPrompt":"Show me the top-level FRED economic data categories and list up to 20 series for category ID 32991.","exampleUseCases":null,"resultDescription":"Returns a list of FRED categories (with IDs, names, and parent relationships) along with up to the requested number of economic data series belonging to the specified category, drawn from the Federal Reserve Bank of St. Louis FRED database.","failureModes":["Invalid categoryId returns empty or error response","seriesLimit outside 0-50 range may be rejected or clamped","Payment failure if insufficient USDC balance via x402","Rate limiting or timeout on FRED upstream"],"whenToPreferThis":"Use this endpoint when you need to browse or navigate the FRED economic data taxonomy, discover what macroeconomic series are available under a given category, or build a hierarchy of Federal Reserve data topics without needing a full FRED API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:06:22.055Z","isFirstParty":false}