{"uid":"cap_RESXj8Bwif6At-hiTG_se","slug":"fathom-macroeconomic-data-api-category-series-18e42aa9","name":"Fathom Macroeconomic Data API — Category Series","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/category-series?utm_source=zero.xyz","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_M_YyTrc096dPj1ZX7MtYH","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 data series belonging to a specified FRED category ID","exampleAgentPrompt":"Pull up to 50 economic time series listed under FRED category 32991 — I want to see what GDP-related series are available there.","exampleUseCases":[{"title":"Exploring inflation data series","prompt":"Show me the first 30 economic time series under FRED category 32455 — I'm looking for inflation and price index series I can use for my analysis."},{"title":"Unemployment indicator discovery","prompt":"What economic time series are available in FRED category 12 for unemployment? Give me up to 20 results so I can see what's there."},{"title":"Interest rate series browsing","prompt":"List the economic data series in FRED category 22 — I want to find interest rate time series to track Fed policy changes."}],"resultDescription":"Returns a JSON object containing an array of economic time series objects (each with series metadata such as ID, name, frequency, units, and observation range), the source attribution, and the queried category ID. The series array is paginated by the limit parameter.","failureModes":["Invalid or nonexistent categoryId returns empty series array or error","Omitting required categoryId field causes a 400/validation error","Limit parameter out of range or non-numeric may cause unexpected results","Upstream FRED API outage may cause degraded or failed responses","Rate limiting or payment failures may block access"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate available FRED economic time series within a known FRED category — for example, to browse what GDP, inflation, unemployment, or interest rate series exist before fetching actual observations. Prefer this over a general search when you already know the FRED category ID and want a structured list of its series. This is a discovery/browsing step, not for fetching time series data values themselves.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:39:02.706Z","isFirstParty":false,"canonicalSlug":"fathom-macroeconomic-data-api-category-series-18e42aa9"}