# Novarithm FX Timeseries

> Novarithm FX Timeseries is a paid API for AI agents from api.novarithm.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-13).

Returns historical foreign exchange rate timeseries data between two currencies over a specified date range, with summary statistics.

## Facts

- Endpoint: GET https://api.novarithm.com/agents/v1/fx/timeseries?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/novarithm-fx-timeseries-f174e4bd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Rgb0HfuHCRClK-X0DolXu

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 novarithm-fx-timeseries-f174e4bd
```

Example prompt: Can you pull the daily GBP to USD exchange rate history from January 1 to March 31, 2026, and show me the stats like the average, min, max, and how much it changed over that period?

## When to prefer this

Choose this endpoint when you need historical daily FX rate data between any two ISO 4217 currencies over a custom date window of up to 366 days, with precomputed statistics (min, max, mean, change %). It uses ECB cross-rates via EUR, making it well-suited for European business contexts, financial reporting, invoice reconciliation, or any agent workflow that needs reliable, low-cost FX history without building rate-fetching infrastructure.

## Known failure modes

- Missing required 'from' or 'to' query parameters returns a validation error
- Invalid ISO 4217 currency code returns an error indicating unrecognized currency
- Date range exceeding 366 days may result in truncation or billing as multiple units
- Network or upstream ECB data unavailability may cause delayed or empty response
- Malformed date format (not YYYY-MM-DD) returns a parse error

## How this service works

Novarithm installe l'IA dans votre entreprise : elle répond à vos clients, trouve de nouveaux clients et fait le répétitif. Payés sur vos résultats.

## Output

A JSON object containing the base and quote currency codes, the date range, a count of data points, an array of daily rate points with their sources, and summary statistics including max, min, mean, first, last rates, and percentage change over the period. Also includes metadata like the method used (ECB cross via EUR), generation timestamp, and response time.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "ISO 4217 quote currency"
      },
      "end": {
       "type": "string",
       "description": "YYYY-MM-DD (default: today)"
      },
      "from": {
       "type": "string",
       "description": "ISO 4217 base currency"
      },
      "start": {
       "type": "string",
       "description": "YYYY-MM-DD (default: end - 30 days)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "to": "USD",
   "end": "2026-03-31",
   "from": "GBP",
   "count": 63,
   "start": "2026-01-02",
   "stats": {
    "max": 1.38166705,
    "min": 1.32299575,
    "last": 1.32415096,
    "mean": 1.34785121,
    "first": 1.34430554,
    "change_pct": -1.4993
   },
   "method": "ecb_cross_via_eur",
   "points": [
    {}
   ],
   "sources": [
    {}
   ],
   "price_usd": 0.005,
   "billing_unit": "series (≤ 366 days)",
   "generated_at": "2026-10-23T10:03:31Z",
   "response_time_ms": 4
  },
  "service": "fx_timeseries"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/novarithm-fx-timeseries-f174e4bd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.novarithm.com](https://www.zero.xyz/host/api.novarithm.com/llms.txt)
