# BRAINIAC FX Rates Timeseries

> BRAINIAC FX Rates Timeseries is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-17).

Returns historical foreign exchange rate timeseries data for a specified base currency, target currencies, and date range.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/fx/rates/timeseries?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-fx-rates-timeseries-1ca2f02f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6KyvsaU3xxVZ-gvjoiusN

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 brainiac-fx-rates-timeseries-1ca2f02f -d '<json body>'
```

Example prompt: Can you pull the daily USD to EUR and GBP exchange rates from January 1st to March 31st 2024, using USD as the base currency?

## When to prefer this

Choose this endpoint when you need historical FX rate data across a custom date range for one or more currency pairs, without needing an account or subscription. It is ideal for AI agents operating autonomously that can pay per-call in USDC via x402 on Base, requiring no prior registration or API key management. Prefer it over subscription FX services when usage is sporadic or when you want to avoid recurring billing.

## Known failure modes

- Invalid date format returns a 400/validation error — dates must follow ISO 8601 YYYY-MM-DD pattern
- Unsupported or misformatted currency codes (not exactly 3 uppercase letters) cause rejection
- Date range where 'from' is after 'to' likely returns an error or empty result
- Payment not completed or insufficient USDC on Base chain results in 402 Payment Required and no data returned
- Very wide date ranges may return large payloads or hit server-side limits
- Weekend or holiday dates may return no rates if the data source does not cover non-trading days

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing date-indexed exchange rate data for the specified base currency against one or more target currencies over the requested date range. Each entry maps a date to the corresponding FX rates for each requested symbol.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "type": "string",
   "format": "date",
   "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
  },
  "base": {
   "type": "string",
   "pattern": "^[A-Z]{3}$"
  },
  "from": {
   "type": "string",
   "format": "date",
   "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
  },
  "symbols": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^[A-Z]{3}$"
    },
    {
     "type": "array",
     "items": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
     }
    }
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "rates": {},
  "source": {
   "url": "https://api.frankfurter.dev/v1/v1/2024-01-01..2024-01-05?base=USD&symbols=EUR%2CGBP",
   "error": "Date not found or invalid parameters",
   "status": "UNAVAILABLE"
  },
  "endDate": "2024-01-05",
  "startDate": "2024-01-01",
  "limitations": [
   "Timeseries exchange rates are retrieved from the Frankfurter API (ECB data).",
   "Rates are delayed reference rates.",
   "Source: European Central Bank."
  ],
  "retrievedAt": "2026-11-07T12:08:57.268Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-fx-rates-timeseries-1ca2f02f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
