{"uid":"cap_VO-HwFudELXONQNLxR9DP","slug":"fathom-macroeconomic-data-api-tag-series-lookup-f2a12647","name":"Fathom Macroeconomic Data API — Tag Series Lookup","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/tag-series","method":"POST","headers":{},"bodySchema":{"type":"object","required":["tag"],"properties":{"tag":{"type":"string","description":"Tag name (e.g. gdp, monthly, inflation, nsa)"},"limit":{"type":"string","description":"Max results (default: 20)"}}},"responseSchema":{"type":"object","required":["source"],"properties":{"tag":{"type":"string"},"series":{"type":"array","items":{"type":"object"}},"source":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KDxT-fPOT_CP4sOOltwS2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of FRED economic time series filtered by a specific tag (e.g. 'gdp', 'inflation', 'monthly', 'nsa')","exampleAgentPrompt":"Using Fathom's FRED-powered API, find me up to 30 economic time series tagged with 'inflation' so I can see what data is available.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the queried tag name, an array of matching FRED economic series objects (each with series metadata), and the data source identifier. Defaults to 20 results unless limit is specified.","failureModes":["Invalid or unknown tag returns empty series array","Missing required 'tag' field returns validation error","Limit parameter not a valid string number may cause unexpected results","FRED upstream unavailability causes service errors","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to discover and browse economic time series by topic or category tag from FRED's 816,000+ series catalog. Ideal for exploratory research into what macroeconomic data is available before fetching actual time series values. Choose this over a general FRED API when you want a simplified, pre-paid per-call interface without managing API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:42:20.104Z","isFirstParty":false}