{"uid":"cap_Tgfze1JqgUGM6Hx4rK4wU","slug":"x402stock-archive-range-endpoint-281a222a","name":"x402stock Archive Range Endpoint","description":"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.","url":"https://x402stock.xyz/api/v1/archive/%7Bfeed%7D/range","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gBKL0zm2yflsTWGxHbIDe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-day denormalized archive summaries for a specified data feed over a date range","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Backtest DeFi pool liquidity trends","prompt":"Can you grab the daily archive data for the ETH/USDC liquidity pool feed from January 1 to January 31, 2026? I want to see how the AUM and virtual price shifted day by day so I can backtest a strategy around liquidity events."},{"title":"Chart a week of CPI history","prompt":"Pull me the daily archived summaries for the US CPI feed from March 1 to March 7, 2026 — I'm building a trend chart and need the day-by-day economic snapshots without having to make a separate call for each date."},{"title":"Analyze on-chain perp funding over time","prompt":"Can you fetch the historical daily snapshots for the BTC on-chain perp feed from May 10 to May 17, 2026? I want to look at how supply and funding metrics evolved across that window to spot any anomalies."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:03:30.281Z","isFirstParty":false}