{"uid":"cap_wGt3IKeTgNeAcWyWQWNlT","slug":"fathom-macroeconomic-data-api-browse-categories-b27ae485","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://fredthom.vercel.app/api/categories","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.35","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.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9M0tvwMg8_gG5VF3UiAZF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.35","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","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) by category ID, enabling navigation of 816,000+ macroeconomic time series","exampleAgentPrompt":"Show me the top-level economic data categories available in Fathom's FRED-powered API — start from category 0 so I can see what's there and drill down from there.","exampleUseCases":null,"resultDescription":"An object containing the source identifier, the queried category_id, and an array of category objects — each with a name and ID — representing all subcategories within the requested FRED category.","failureModes":["Invalid or non-existent categoryId returns empty categories array or error","Network timeout from upstream FRED API proxy","Payment failure (402) if USDC payment is not processed correctly","Malformed request body returns 400-level error"],"whenToPreferThis":"Use this endpoint when you need to discover or navigate the hierarchical structure of FRED economic data categories before fetching actual time series data. Ideal as a first step to understand what data is available under a given topic (e.g., GDP, inflation, unemployment) before querying specific series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:19.585Z","isFirstParty":false}