# Datakoot FX Timeseries

> Datakoot FX Timeseries is a paid API for AI agents from x402.datakoot.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns daily historical foreign exchange rates for one or more currency pairs over a date range, sourced from ECB reference rates via Frankfurter.

## Facts

- Endpoint: POST https://x402.datakoot.com/api/fx_timeseries?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datakoot-fx-timeseries-88cdafd1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KVjB3JZrG0-sx0QWyJvsN

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 datakoot-fx-timeseries-88cdafd1 -d '<json body>'
```

Example prompt: Can you pull the daily USD to EUR and GBP exchange rates from September 1 to September 10, 2026 using ECB reference rates?

## When to prefer this

Choose this endpoint when you need a multi-day historical timeseries of foreign exchange rates (not just a single point-in-time rate), especially when ECB reference rates are acceptable. Ideal for financial reconciliation, trend analysis, or reporting over a period up to about one year. Prefer over live-rate endpoints when historical accuracy across a date range is the requirement rather than a current spot rate.

## Known failure modes

- Invalid or unsupported currency symbol returns an error or empty rates
- Date range exceeding approximately one year may be rejected
- Malformed date format outside YYYY-MM-DD or MM/DD/YYYY may cause a parsing error
- ECB does not publish rates on weekends/holidays so those dates may be missing from output
- Payment failure via x402 means the call is not charged and data is not returned

## How this service works

48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) for AI agents. $0.002 USDC per call on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at <server>.datakoot.com/mcp.

## Output

A JSON object containing the base currency, a nested rates object keyed by date (YYYY-MM-DD) with each requested currency symbol and its rate, plus start_date, end_date, and a source note citing ECB reference rates via Frankfurter (informational only, not a transaction benchmark).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "end": {
   "type": "string",
   "description": "End date, YYYY-MM-DD (MM/DD/YYYY is also accepted)."
  },
  "base": {
   "type": "string",
   "description": "3-letter base (default USD)"
  },
  "start": {
   "type": "string",
   "description": "Start date, YYYY-MM-DD (MM/DD/YYYY is also accepted). Range up to about one year."
  },
  "symbols": {
   "type": "string",
   "description": "Comma-separated targets, e.g. EUR,GBP"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "rates": {
   "2026-09-01": {
    "EUR": 0.86281
   },
   "2026-09-02": {
    "EUR": 0.86371
   },
   "2026-09-03": {
    "EUR": 0.86096
   },
   "2026-09-04": {
    "EUR": 0.86044
   },
   "2026-09-07": {
    "EUR": 0.86044
   },
   "2026-09-08": {
    "EUR": 0.86103
   },
   "2026-09-09": {
    "EUR": 0.85822
   },
   "2026-09-10": {
    "EUR": 0.86088
   }
  },
  "source": "ECB reference rates via Frankfurter (information only; not a transaction benchmark)",
  "end_date": "2026-09-10",
  "start_date": "2026-09-01"
 }
}
```

## More

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