# x402stock Archive Range Endpoint

> x402stock Archive Range Endpoint is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Returns per-day denormalized archive summaries for a specified data feed over a date range

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/archive/%7Bfeed%7D/range
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-archive-range-endpoint-281a222a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tgfze1JqgUGM6Hx4rK4wU

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 x402stock-archive-range-endpoint-281a222a
```

Example prompt: Can you pull the archived daily summaries for the sol.jlp feed from June 1 to June 8, 2026 — I want to see the supply, AUM, and virtual price for each day?

## When to prefer this

Use this endpoint when you need multiple consecutive days of archived data for a specific feed (crypto pool, on-chain perp, macro series, etc.) and want to avoid making one call per day. It is ideal for time-series analysis, backtesting, or trend visualization over a date window. Prefer the single-date archive endpoint if you only need one day's full payload.

## Known failure modes

- Invalid feed identifier returns an error or empty result
- Date range outside available archive data returns empty days array
- Malformed date format causes a 400 bad request
- Payment not received or insufficient USDC causes a 402 Payment Required
- Feed with no data in the requested range returns count: 0
- Network or upstream data source unavailability causes 5xx errors

## How this service works

Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.

## Output

A JSON object containing: the feed name, from/to date range, count of days returned, an as_of timestamp, and a days array where each entry has observed_date, captured_at, observed_at, content_hash, and a summary object with fields like supply, aum_usd, and virtual_price. Days are returned oldest-first.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-06-08",
  "days": [
   {
    "summary": {
     "supply": 364102108.2,
     "aum_usd": 1518230114.77,
     "virtual_price": 4.1779
    },
    "captured_at": "2026-06-07T00:05:10.221Z",
    "observed_at": "2026-06-07T00:05:09.000Z",
    "content_hash": "4c8a2e6f0b3d7a1c5e9f3b7d1a5c9e3f7b1d5a9c3e7f1b5d9a3c7e1f5b9d3a7c",
    "observed_date": "2026-06-07"
   },
   {
    "summary": {
     "supply": 364182931.5,
     "aum_usd": 1523456789.12,
     "virtual_price": 4.1832
    },
    "captured_at": "2026-06-08T00:05:13.412Z",
    "observed_at": "2026-06-08T00:05:12.000Z",
    "content_hash": "9f2b41c7a6e8d3051b9e7c2a4f8d6e0c3a5b7d9f1e2c4a6b8d0f2e4c6a8b0d1f",
    "observed_date": "2026-06-08"
   }
  ],
  "feed": "sol.jlp",
  "from": "2026-06-07",
  "note": "Per-day denormalized summaries, oldest first. Buy a full day's payload via /api/v1/archive/{feed}?date=YYYY-MM-DD.",
  "as_of": "2026-06-08T13:02:11.000Z",
  "count": 2,
  "entity": "_pool",
  "source": "x402stock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-archive-range-endpoint-281a222a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)