{"uid":"cap_22GPTDpZ8ZEuQKlZjfGrq","slug":"fathom-macroeconomic-data-api-browse-categories-27537e30","name":"Fathom Macroeconomic Data API — Browse Categories","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fredfathom.vercel.app/api/categories?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"categoryId":{"type":"string","description":"Category ID (default: 0 for top-level)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"source":{"type":"string"},"categories":{"type":"array","items":{"type":"object"}},"category_id":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QtWgLZ3o-Ns0UmivfTQjE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of FRED economic data categories (or subcategories) to help navigate 816,000+ macroeconomic time series","exampleAgentPrompt":"Can you show me the top-level FRED economic data categories so I can figure out which category covers inflation and price indexes?","exampleUseCases":[{"title":"Exploring FRED category tree","prompt":"Show me all the top-level categories available in the FRED macroeconomic database so I can figure out where to find GDP-related data series."},{"title":"Finding subcategories for monetary data","prompt":"I'm looking for interest rate data in FRED — can you list the subcategories under the money and banking category? The category ID is 15."},{"title":"Building an economic data navigator","prompt":"For my dashboard, I need to list all the subcategories under FRED's national accounts category — what subcategories are available under category ID 32992?"}],"resultDescription":"Returns a JSON object containing the source (FRED), the requested category_id, and an array of category objects each with metadata such as category name, ID, and parent category — enabling navigation of the full FRED taxonomy.","failureModes":["Invalid or non-existent categoryId returns empty categories array or error","Network timeout on Vercel deployment under high load","Category ID for a leaf node with no children returns empty subcategory list","Missing categoryId defaults to 0 (top-level) which may not be what caller intended"],"whenToPreferThis":"Use this endpoint when you need to discover or navigate the FRED category hierarchy before fetching specific economic time series. It is the right choice when you don't know the exact series ID and want to browse by topic (e.g. GDP, inflation, unemployment). Prefer this over direct series search when building category-aware navigation, dashboards, or when helping a user explore what macroeconomic data is available.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T00:36:05.340Z","isFirstParty":false,"canonicalSlug":"fathom-macroeconomic-data-api-browse-categories-27537e30"}