{"uid":"cap_3eWe29tQX3mmAh2geMXwb","slug":"fathom-category-series-lookup-fred-powered-macroeconomic-data-api-1c5d0581","name":"Fathom — Category Series Lookup (FRED-powered Macroeconomic Data API)","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-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_f_m1_fmwNDU45CRU2HSI8","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 the list of economic data series belonging to a given FRED category, such as GDP, inflation, or unemployment series grouped under a category ID.","exampleAgentPrompt":"Pull up all the economic time series listed under FRED category 32455 — show me up to 50 series so I can see what GDP-related data is available.","exampleUseCases":[{"title":"Exploring inflation data series","prompt":"What time series are available under the FRED inflation category? Give me up to 30 series so I can see what CPI and PCE data is in there."},{"title":"Building a macroeconomic dashboard","prompt":"I'm building an economic dashboard — can you fetch all the series listed under FRED category 106 (the national accounts category) so I know what indicators I can pull?"},{"title":"Researching unemployment indicators","prompt":"List all the economic data series under FRED's unemployment category ID 12 — I want to see every series available, up to 50 results."}],"resultDescription":"Returns a JSON object containing an array of economic time series objects (each with series metadata like ID, title, frequency, units, and dates), the source attribution string ('FRED'), and the requested category ID. The series array contains structured metadata about each data series available under the specified FRED category.","failureModes":["Invalid or non-existent categoryId returns empty series array or error","Missing categoryId field causes a 400-level validation error","Limit parameter set too high may slow response or hit upstream FRED rate limits","FRED upstream API downtime results in service unavailability","Non-numeric or malformed categoryId may cause unexpected behavior"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate what economic time series exist under a specific FRED category — i.e., when you know the category but want to list the series within it. Prefer this over a general series search when you already have a FRED category ID and want to browse its contents systematically. It is particularly useful for building data pipelines or dashboards that need to enumerate available indicators by category.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:49:46.408Z","isFirstParty":false}