{"uid":"cap_Ib8K4qH5dK9sKVHe5EzuS","slug":"fathom-macroeconomic-data-api-category-series-lookup-97711b00","name":"Fathom Macroeconomic Data API — Category Series Lookup","description":"Free macroeconomic data API powered by FRED. 816,000+ economic time series. GDP, inflation, unemployment, interest rates, and more.","url":"https://fathom-opal.vercel.app/api/category-series","method":"POST","headers":{},"bodySchema":{"type":"object","required":["categoryId"],"properties":{"limit":{"type":"string","description":"Max results (default: 20)"},"categoryId":{"type":"string","description":"FRED category ID"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"series":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"category_id":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vyECVtl14Wb3LfSLz1n90","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of FRED economic time series belonging to a specified category, such as GDP, inflation, or unemployment indicators.","exampleAgentPrompt":"Can you pull up all the economic time series available under FRED category 32455 — I want to see what inflation-related data series are in there, show me up to 30 results.","exampleUseCases":[{"title":"Exploring GDP data series by category","prompt":"I want to see what GDP time series are available under FRED category 106 — list up to 20 of them so I can decide which one to use for my analysis."},{"title":"Discovering unemployment indicators","prompt":"Can you browse FRED category 10 and list the available unemployment data series? I'd like to see what's there before I start pulling actual data."},{"title":"Finding interest rate series for a dashboard","prompt":"Show me the economic series available in FRED category 22 related to interest rates — give me up to 25 results so I can pick the right ones to include in my dashboard."}],"resultDescription":"An array of FRED time series objects belonging to the requested category, each containing series metadata (likely series ID, title, units, frequency, and other descriptors), along with the source attribution string and the category ID that was queried.","failureModes":["Invalid or non-existent categoryId returns an empty series array or error","Missing required categoryId field causes a validation error","Limit parameter out of expected range may be ignored or cause an error","FRED upstream unavailability results in failed data retrieval","Very large categories may return truncated results if limit is not specified"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate what time series exist within a known FRED category, rather than fetching actual data values. Ideal for building category browsers, populating series selection menus, or exploring what macroeconomic indicators are available before committing to a specific series. Prefer this over a general FRED search when you already know the category ID and want a structured list of its series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:45.565Z","isFirstParty":false}