# x402stock Forex Pair Aggregate Bars

> x402stock Forex Pair Aggregate Bars is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns OHLCV aggregate bar data (open, high, low, close, volume, VWAP) for a forex currency pair over a specified time range and resolution, paid per-request in USDC via x402.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/forex/%7Bpair%7D/aggregates
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-forex-pair-aggregate-bars-8dba9fea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_owIgc1PkflITuHCbex6Db

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-forex-pair-aggregate-bars-8dba9fea
```

Example prompt: Pull daily OHLCV aggregate bars for EUR/USD from January 1 2025 to June 1 2025, 1-day timespan, adjusted, sorted ascending, limit 500.

## When to prefer this

Use this endpoint when you need historical OHLCV candlestick/bar data for a forex currency pair with flexible time resolution (from minute to year), no API key setup, and pay-per-call pricing in USDC. Prefer over subscription-based forex APIs when you need occasional or agent-driven on-demand lookups without account management.

## Known failure modes

- Invalid or unsupported currency pair returns 404 or empty bars array
- Payment not received / x402 payment required returns HTTP 402
- Date range too large or limit exceeded returns validation error
- Invalid timespan or multiplier value returns 400 bad request
- Network timeout for large date ranges with minute-level granularity

## 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 an array of OHLCV bar objects for the requested forex pair, each with open, high, low, close, volume, VWAP, trade count, and timestamp fields, plus a total bar count, adjusted flag, data source identifier, ticker symbol, and as-of timestamp.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "multiplier",
      "timespan",
      "from",
      "to",
      "adjusted",
      "sort",
      "limit"
     ],
     "properties": {
      "to": {
       "type": "string",
       "default": "2026-09-16",
       "minLength": 1
      },
      "from": {
       "type": "string",
       "default": "2025-09-16",
       "minLength": 1
      },
      "sort": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "asc"
      },
      "limit": {
       "type": "integer",
       "default": 5000,
       "maximum": 50000,
       "exclusiveMinimum": 0
      },
      "adjusted": {
       "type": "boolean",
       "default": true
      },
      "timespan": {
       "enum": [
        "minute",
        "hour",
        "day",
        "week",
        "month",
        "quarter",
        "year"
       ],
       "type": "string",
       "default": "day"
      },
      "multiplier": {
       "type": "integer",
       "default": 1,
       "maximum": 50000,
       "exclusiveMinimum": 0
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "ticker",
      "data",
      "source",
      "as_of"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "bars",
        "count"
       ],
       "properties": {
        "bars": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "open",
           "high",
           "low",
           "close",
           "volume",
           "vwap",
           "trade_count",
           "timestamp"
          ],
          "properties": {
           "low": {
            "type": "number"
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "bars": [
    {
     "low": 192.5,
     "high": 196,
     "open": 193,
     "vwap": 194.8,
     "close": 195.12,
     "volume": 50000000,
     "timestamp": "2026-05-28T04:00:00.000Z",
     "trade_count": 450000
    }
   ],
   "count": 1,
   "adjusted": true
  },
  "as_of": "2026-05-29T20:00:00.000Z",
  "source": "x402stock",
  "ticker": "AAPL"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-forex-pair-aggregate-bars-8dba9fea/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)