# ADH FX Historical Exchange Rates

> ADH FX Historical Exchange Rates is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches historical foreign exchange rate time series data (ECB/Frankfurter source) for a specified currency pair and date range

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/fx-hist
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adh-fx-historical-exchange-rates-5ce89048
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ndwO-82NL7FExfpKF9H6J

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 adh-fx-historical-exchange-rates-5ce89048
```

Example prompt: Pull the historical USD to CNY exchange rates from May 11 to August 9, 2026 — I need the full daily series with source attribution.

## When to prefer this

Choose this endpoint when you need historical daily FX rate time series from an ECB-sourced dataset, especially for USD as base currency against major pairs, and want source attribution and timestamped collection metadata included. It is ideal for macro regime analysis, backtesting, or enriching financial intelligence pipelines, and costs only $0.01 USDC per call via x402 agent-native payment — no API key required.

## Known failure modes

- Unsupported currency pair returns an error or empty series
- Date range too far back may exceed ECB data availability
- Malformed query parameters yield 400-level errors
- Payment failure via x402 blocks access (402 response)
- ECB/Frankfurter upstream outage causes data unavailability

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

Returns a JSON object containing: the base currency, the date range queried, total number of data points, a daily time series array of {date, rate, quote} objects, the underlying data source (Frankfurter/ECB), data type label in Chinese (外汇), and a UTC collection timestamp.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ]
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "required": []
    }
   },
   "required": [
    "type",
    "method"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "base": "USD",
   "range": "2026-05-11..2026-08-09",
   "points": 364,
   "series": [
    {
     "date": "2026-05-11",
     "rate": 6.7928,
     "quote": "CNY"
    },
    {
     "date": "2026-05-11",
     "rate": 6.7928,
     "quote": "CNY"
    }
   ],
   "source": "Frankfurter (ECB data, no key)"
  },
  "source": "frankfurter",
  "data_type": "外汇",
  "collected_at": "2026-08-09T18:27:02Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-fx-historical-exchange-rates-5ce89048/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)