{"uid":"cap_TgnvcnkG9uivlR_cP49YL","slug":"fathom-macroeconomic-data-api-category-tree-b504db4e","name":"Fathom Macroeconomic Data API — Category Tree","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fathoms.vercel.app/api/category-tree","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"categoryId":{"type":"string","description":"Parent category ID (default: 0 for root)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"source":{"type":"string"},"children":{"type":"array","items":{"type":"object"}},"parent_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_6afIxEfcbqSRv086iTRVt","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 hierarchical category tree of FRED macroeconomic data series, starting from a given parent category ID","exampleAgentPrompt":"Show me the subcategories under FRED's root category so I can explore what macroeconomic data series are available — start from the top-level category tree.","exampleUseCases":[{"title":"Exploring GDP data categories","prompt":"I want to explore what GDP-related economic data is available on FRED — can you show me the subcategories under the GDP category so I know what series I can pull?"},{"title":"Navigating inflation data hierarchy","prompt":"Walk me through the FRED category tree for inflation data — what are the child categories under the prices or inflation section?"},{"title":"Discovering top-level FRED categories","prompt":"Give me all the top-level categories in the FRED macroeconomic database so I can understand the full structure of what economic data is available."}],"resultDescription":"Returns an object containing the data source identifier, the parent category ID, and an array of child category objects representing the subcategories at that level of the FRED taxonomy.","failureModes":["Invalid or non-existent categoryId returns empty children array or error","Payment failure (insufficient USDC balance) blocks the request","Network timeout from upstream FRED API causes delayed or failed response","Malformed request body returns validation error"],"whenToPreferThis":"Use this endpoint when you need to discover or navigate the hierarchical structure of FRED economic data categories before fetching specific time series. It is ideal for building category browsers, exploring available data domains, or programmatically finding the right category to retrieve GDP, inflation, unemployment, or interest rate series. Prefer this over direct series search when you want a structured taxonomy view rather than keyword-based series lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:45:04.678Z","isFirstParty":false}