{"uid":"cap_D01iOoHGdOX3eql9ysUfH","slug":"us-retail-sales-yoy-growth-rate-fred-rsafs-c5d59da6","name":"US Retail Sales YoY Growth Rate (FRED RSAFS)","description":"US retail sales year-over-year growth rate, via FRED (RSAFS)","url":"https://finance-api.kdlcfa.workers.dev/retail-sales?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VlGDjQ9BANyOaDnzkpUyV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the US retail sales year-over-year growth rate sourced from the Federal Reserve Economic Data (FRED) RSAFS series","exampleAgentPrompt":"What's the latest year-over-year US retail sales growth rate from FRED — pull the current RSAFS figure for me.","exampleUseCases":[{"title":"Macro dashboard economic indicator","prompt":"Add the current US retail sales year-over-year growth rate to my macro dashboard — I need the latest FRED RSAFS reading."},{"title":"Consumer spending trend analysis","prompt":"Is US consumer spending growing or shrinking right now? Grab the latest year-over-year retail sales figure from FRED so I can see the trend."},{"title":"Fed policy research briefing","prompt":"I'm putting together a briefing on the US economic outlook — can you pull the most recent FRED retail sales YoY growth number to include in the consumer demand section?"}],"resultDescription":"Returns the US retail sales year-over-year growth rate derived from the FRED RSAFS (Advance Retail Sales: Retail Trade and Food Services) series, typically expressed as a percentage change relative to the same period in the prior year.","failureModes":["FRED upstream outage may return a 502 or empty response","Stale data if FRED has not yet published the latest monthly release","Rate limiting or payment failure returns a 402 Payment Required","No query parameters available, so no filtering or historical range is possible"],"whenToPreferThis":"Choose this endpoint when you need a single, current US retail sales year-over-year growth metric sourced directly from FRED RSAFS without building your own FRED API integration. It is ideal for macro dashboards, economic briefings, or automated monitoring of consumer spending trends. Prefer it over raw FRED API access when a quick, paid, no-auth call is sufficient and you don't need historical time series or custom date ranges.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:37:02.343Z","isFirstParty":false,"canonicalSlug":"us-retail-sales-yoy-growth-rate-fred-rsafs-c5d59da6"}