# Currency Time Series

> Currency Time Series is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns historical forex exchange rate time series for a currency pair over configurable periods from 1 day to all-time (MAX).

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-finance-data/currency-time-series?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-currency-time-series-8279502f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9qVJmFEgrRNKd6vSZCXAi

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 agents-openwebninja-com-currency-time-series-8279502f
```

Example prompt: Can you pull the 1-year historical exchange rate time series for EUR to USD so I can see how the euro has trended against the dollar over the past year?

## When to prefer this

Choose this endpoint when you need historical forex exchange rate data over a defined period (1D to MAX) for any supported ISO 4217 currency pair, especially when you want timestamped snapshots with change metrics. Prefer this over spot-rate-only endpoints when trend analysis, charting, or monitoring over time is needed.

## Known failure modes

- Invalid ISO 4217 currency code returns an error or empty data
- Unsupported period value causes validation error
- Unavailable currency pair may return no time series data
- Rate limiting or payment/credit exhaustion returns 402
- Network timeout for large MAX period datasets

## How this service works

Get forex time series for the following periods: 1 day, 5 days, 1 month, 6 months, year-to-date, 1 year, 5 years and all times (max).

## Output

Returns a structured object containing timestamped exchange rate snapshots keyed by timestamp, each with the exchange rate, absolute change, and percent change from previous close; plus the current exchange rate, previous close, update timestamp, UTC offset, interval between data points in seconds, and the period and currency pair metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "from_symbol",
  "to_symbol"
 ],
 "properties": {
  "period": {
   "type": "string",
   "description": "Period for which to return time series and key events.  \n\n  **Periods:**  \n  `1D - 1 day`  \n  `5D - 5 days`  \n  `1M - 1 month`  \n  `6M - 6 months`  \n  `YTD - year-to-date`  \n  `1Y - 1 year`  \n  `5Y - 5 years`  \n  `MAX - all times` "
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language to use for the results, specified as a 2-letter language code - see ISO 639-1."
  },
  "to_symbol": {
   "type": "string",
   "description": "A 3-Letter currency code / symbol (ISO 4217) to convert to."
  },
  "from_symbol": {
   "type": "string",
   "description": "A 3-Letter currency code / symbol (ISO 4217) to convert."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "description": "Type of exchange rate data"
    },
    "period": {
     "type": "string",
     "description": "Time period covered by the time series"
    },
    "to_symbol": {
     "type": "string",
     "description": "Target currency symbol for conversion"
    },
    "from_symbol": {
     "type": "string",
     "description": "Base currency symbol for conversion"
    },
    "time_series": {
     "type": "object",
     "description": "Historical exchange rate data keyed by timestamp. Each value is an exchange-rate snapshot at that timestamp.",
     "additionalProperties": {
      "type": "object",
      "properties": {
       "change": {
        "type": "number",
        "description": "Absolute change from the previous close at this timestamp."
       },
       "exchange_rate": {
        "type": "number",
        "description": "Exchange rate at this timestamp."
       },
       "change_percent": {
        "type": "number",
        "description": "Percent change from the previous close at this timestamp."
       }
      }
     }
    },
    "interval_sec": {
     "type": "integer",
     "description": "Time interval between data points in seconds"
    },
    "exchange_rate": {
     "type": "number",
     "description": "Current exchange rate value"
    },
    "previous_close": {
     "type": "number",
     "description": "Previous closing exchange rate"
    },
    "utc_offset_sec": {
     "type": "integer",
     "description": "UTC offset in seconds for time series data"
    },
    "last_update_utc": {
     "type": "string",
     "description": "Timestamp of last update in UTC format"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "Status of the API response"
  },
  "request_id": {
   "type": "string",
   "description": "Unique identifier for the API request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-currency-time-series-8279502f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)