{"uid":"cap_jJkhpRkDw-pqLFk84xz2O","slug":"2s-io-us-macroeconomic-indicators-1b5bf5b7","name":"2s.io US Macroeconomic Indicators","description":"Latest reading of a curated US macroeconomic indicator, with the prior + year-ago values and YoY % change. Pass indicator for one, or omit for all. Indicators: unemployment-rate, fed-funds-rate, nonfarm-payrolls, jobless-claims, labor-force-participation, real-gdp, gdp-growth, 10y-treasury, 2y-treasury, 3m-treasury, 30y-mortgage, consumer-sentiment, housing-starts, retail-sales, industrial-production, m2, personal-saving-rate — i.e. unemployment rate, fed funds rate, nonfarm payrolls, jobless claims, labor-force participation, real GDP + GDP growth, 2y/3m/10y Treasury yields, 30y mortgage rate, consumer sentiment, housing starts, retail sales, industrial production, M2, personal saving rate. Each result names the FRED series ID + units. Source: BLS/BEA/Fed/Treasury via FRED (St. Louis Fed). For inflation specifically use inflation.rates; for any raw series use bls.series.","url":"https://2s.io/api/econ/indicator","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"indicator":{"type":"string","description":"One indicator, or omit for all. One of: unemployment-rate, fed-funds-rate, nonfarm-payrolls, jobless-claims, labor-force-participation, real-gdp, gdp-growth, 10y-treasury, 2y-treasury, 3m-treasury, 30y-mortgage, consumer-sentiment, housing-starts, retail-sales, industrial-production, m2, personal-saving-rate."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"indicator":"unemployment-rate"}}},"response":{"data":{"ok":true,"items":[{"asOf":"2026-05-01","label":"Unemployment rate","units":"percent","value":4.3,"yearAgo":4.3,"previous":4.3,"seriesId":"UNRATE","indicator":"unemployment-rate","changeYoYPct":0}],"total":1,"source":{"url":"https://fred.stlouisfed.org/","license":"FRED® data; many series are public domain (US govt). Attribution to FRED required for redistribution.","provider":"Federal Reserve Bank of St. Louis — FRED"}},"meta":{"cost":{"usd":0.00144,"tier":0},"caller":"x402","version":null,"endpoint":"econ.indicator","settlement":{"txHash":"0x52504fc5e678c0a0f7ee8134e0ae65ebb9312df40593674edb3dcd2b631087c8","network":"eip155:8453","success":true}}}},"exampleRequest":{"indicator":"unemployment-rate"},"tags":["x402"],"displayCostAmount":"0.00144","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00144/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0036","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_60nJyu17kb0b3Ro7gY0cI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0036","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest reading of a curated US macroeconomic indicator (plus prior and year-ago values and YoY % change) sourced from FRED (BLS/BEA/Fed/Treasury).","exampleAgentPrompt":"What is the current US unemployment rate — give me the latest reading along with the prior value and how it's changed compared to a year ago?","exampleUseCases":[{"title":"Monitor Fed policy rate movements","prompt":"What's the current federal funds rate? I need to see how it's moved from the last reading and where it stood a year ago to understand the trajectory of monetary policy."},{"title":"Track housing market health indicators","prompt":"Pull the latest housing starts and 30-year mortgage rate for me. I want to compare both to last month's figures and year-ago levels to see if the market is cooling or heating up."},{"title":"Assess consumer economic strength","prompt":"Give me a snapshot of consumer sentiment and retail sales — show me the current readings, prior values, and year-over-year changes so I can gauge whether households are still spending confidently."}],"resultDescription":"A JSON object containing the latest value, prior value, year-ago value, and year-over-year percent change for the requested macroeconomic indicator, along with the FRED series ID and measurement units. If no indicator is specified, results for all 17 supported indicators are returned.","failureModes":["Invalid indicator slug returns an error or empty result","Indicator data not yet updated for current period returns stale reading","Network or payment failure prevents response","Omitting indicator when only one is needed returns all 17 indicators, increasing payload size"],"whenToPreferThis":"Use this endpoint when you need a quick, pre-curated snapshot of a US macroeconomic indicator with built-in context (prior and year-ago values, YoY change) without needing to query raw FRED series directly. Prefer this over raw BLS series endpoints when you want a normalized, ready-to-use macro data point. For inflation specifically, use the dedicated inflation.rates endpoint; for raw FRED series data, use bls.series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:01:01.434Z","isFirstParty":false}