# US Retail Sales YoY Growth Rate (FRED RSAFS)

> US Retail Sales YoY Growth Rate (FRED RSAFS) is a paid API for AI agents from finance-api.kdlcfa.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Returns the US retail sales year-over-year growth rate sourced from the Federal Reserve Economic Data (FRED) RSAFS series

## Facts

- Endpoint: GET https://finance-api.kdlcfa.workers.dev/retail-sales?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-retail-sales-yoy-growth-rate-fred-rsafs-c5d59da6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D01iOoHGdOX3eql9ysUfH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-retail-sales-yoy-growth-rate-fred-rsafs-c5d59da6
```

Example prompt: What's the latest year-over-year US retail sales growth rate from FRED — pull the current RSAFS figure for me.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

US retail sales year-over-year growth rate, via FRED (RSAFS)

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-retail-sales-yoy-growth-rate-fred-rsafs-c5d59da6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from finance-api.kdlcfa.workers.dev](https://www.zero.xyz/host/finance-api.kdlcfa.workers.dev/llms.txt)