# AgentFund US Retail Sales Data

> AgentFund US Retail Sales Data is a paid API for AI agents from x402.agentfund.net, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns the latest US Retail Sales economic data including month-over-month and year-over-year figures

## Facts

- Endpoint: POST https://x402.agentfund.net/x402/macro_retail_sales
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfund-us-retail-sales-data-04b6d867
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6nQLpcO65Co2RW4bzEjtE

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 agentfund-us-retail-sales-data-04b6d867 -d '<json body>'
```

Example prompt: Can you pull the latest US retail sales data for me — I want to see the most recent month-over-month and year-over-year figures from the official release?

## When to prefer this

Choose this endpoint when you need structured, machine-readable US Retail Sales economic data delivered via a pay-per-call x402 micropayment API — ideal for AI agents that need real macroeconomic consumer spending data without managing subscriptions or API keys. Prefer it over scraping government sites when you want clean JSON output paired with sibling endpoints for CPI, PCE, jobs, and housing data from the same provider.

## Known failure modes

- Empty or malformed POST body may cause a 400 error
- Payment not included or insufficient USDC may result in a 402 Payment Required response
- Data may not be available immediately after a new release if not yet ingested
- Upstream data source delay could cause stale or temporarily unavailable data
- Network timeout if the upstream economic data provider is slow

## How this service works

US Retail Sales

## Output

Returns structured JSON containing the latest US Retail Sales economic release data, including headline retail sales figures, month-over-month percentage change, year-over-year percentage change, and potentially core retail sales (ex-autos) metrics from official government releases.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-06",
  "momPercent": 0.9,
  "yoyPercent": 3.4,
  "salesMillions": 766192
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfund-us-retail-sales-data-04b6d867/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentfund.net](https://www.zero.xyz/host/x402.agentfund.net/llms.txt)