# FXRate History by YourAITools

> FXRate History by YourAITools is a paid API for AI agents from api.youraitools.co, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-25).

Returns daily ECB reference rates for a currency pair over a date range (up to 366 days, back to 1999), including time-series data points and summary statistics.

## Facts

- Endpoint: GET https://api.youraitools.co/fx/v1/history?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fxrate-history-by-youraitools-d08eb003
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yFKHDuFHr3qBtWNPvQj8t

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 fxrate-history-by-youraitools-d08eb003
```

Example prompt: Can you pull the daily EUR/USD exchange rates from January 1 to March 31 2024 using ECB reference data, and tell me the first rate, last rate, min, max, and total percent change over that period?

## When to prefer this

Choose this endpoint when you need historical ECB daily reference rates for a specific currency pair over a defined date window, especially when you also need summary statistics (first, last, min, max, percent change) computed server-side. It is ideal for trend analysis, reporting, or charting up to a year of FX history. Prefer alternatives if you need real-time live rates, intraday tick data, rates for currencies outside the 31 ECB-supported ones, or multi-pair batch queries in a single call.

## Known failure modes

- Missing required parameters (base, quote, start) returns a 4xx error
- Date range exceeding 366 days returns an error
- Unsupported currency codes (outside the 31 ECB-supported currencies) return an error
- Start date before 1999 (ECB data inception) may return empty or error
- Weekend/holiday dates return no data points for those days (ECB only publishes on business days)
- Network or upstream Frankfurter API outage may cause 5xx responses

## How this service works

Historical exchange rate API for AI agents. Daily ECB reference rates for one currency pair between two dates (up to 366 days, back to 1999), with first, last, min, max and percent change. Search intents: historical exchange rates api, fx time series, currency history, eur usd chart data, forex history.

## Output

A JSON object containing the base and quote currency codes, the requested date range, an array of daily {date, rate} data points (business days only per ECB), and a stats block with first, last, min, max, and change_pct (percent change from first to last). Also includes the data source attribution (ECB via Frankfurter).

## 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": [
      "base",
      "quote",
      "start"
     ],
     "properties": {
      "end": {
       "type": "string",
       "description": "YYYY-MM-DD end date (default: today); max 366 days after start"
      },
      "base": {
       "type": "string",
       "description": "Base currency: ISO 4217 code, e.g. USD, EUR, GBP, JPY (31 supported)"
      },
      "quote": {
       "type": "string",
       "description": "Quote currency: ISO 4217 code, e.g. USD, EUR, GBP, JPY (31 supported)"
      },
      "start": {
       "type": "string",
       "description": "YYYY-MM-DD start date"
      }
     },
     "description": "Search intents: historical exchange rates api, fx time series, currency history, eur usd history, forex history"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "base",
      "quote",
      "points"
     ],
     "properties": {
      "end": {
       "type": "string"
      },
      "base": {
       "type": "string"
      },
      "quote": {
       "type": "string"
      },
      "start": {
       "type": "string"
      },
      "stats": {
       "type": "object",
       "properties": {
        "max": {
         "type": "number"
        },
        "min": {
         "type": "number"
        },
        "last": {
         "type": "number"
        },
        "first": {
         "type": "number"
        },
        "change_pct": {
         "type": "number"
        }
       }
      },
      "points": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": "string"
         },
         "rate": {
          "type": "number"
         }
        }
       }
      },
      "source": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "end": "2026-10-23",
  "base": "EUR",
  "count": 17,
  "quote": "USD",
  "start": "2026-10-01",
  "stats": {
   "max": 1.1298,
   "min": 1.1172,
   "last": 1.1193,
   "first": 1.1298,
   "change_pct": -0.93
  },
  "points": [
   {
    "date": "2026-10-01",
    "rate": 1.1298
   },
   {
    "date": "2026-10-02",
    "rate": 1.1225
   },
   {
    "date": "2026-10-23",
    "rate": 1.1193
   }
  ],
  "source": "Source: ECB statistics (euro foreign exchange reference rates), via the open-source Frankfurter API."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fxrate-history-by-youraitools-d08eb003/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)