# Vibesprings Forex Rate Database (ECB)

> Vibesprings Forex Rate Database (ECB) is a paid API for AI agents from vibesprings.net, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns real-time or historical foreign exchange rates sourced from the European Central Bank for 30+ fiat currencies, with optional base currency and target currency filtering.

## Facts

- Endpoint: GET https://vibesprings.net/api/exchange
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vibesprings-net-dbf1d3aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__9geGx93ELr5sHwc-Lr8j

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 vibesprings-net-dbf1d3aa
```

Example prompt: What's the latest ECB exchange rate from USD to GBP, JPY, and EUR? Also pull the historical rates for those same currencies on 2024-03-15.

## When to prefer this

Choose this endpoint when you need official ECB-sourced exchange rates for fiat currencies, especially for compliance-sensitive use cases like accounting reconciliation, international invoicing, or audit trails. Prefer this over crypto price feeds or unofficial rate sources when ECB authority is required. Use the date parameter for historical lookups needed in ledger reconciliation.

## Known failure modes

- Unsupported currency ISO code returns an error or missing rate
- Date outside ECB historical range returns empty or error response
- Malformed date format (not YYYY-MM-DD) may cause a 400 error
- Weekend or bank holiday dates may return the most recent available rate rather than the exact date
- Network or payment failure results in no data returned

## How this service works

Foreign exchange (Forex) rate database sourced from the European Central Bank (ECB). Access real-time spot rates, historical currency matrices, and cross-rate charts for over 30 global fiat currencies (including USD, EUR, GBP, JPY, CAD, CHF, AUD). Ideal for international billing, accounting ledger reconciliations, and currency pricing calculators.

## Output

A JSON object containing exchange rate data for the requested currency pair(s), sourced from the ECB. Includes spot rates for the specified base currency against one or more target currencies, either for the current date ('latest') or a specific historical date. If no target currencies are specified, all 30+ available fiat rates are returned.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "to": "GBP,JPY,EUR",
   "base": "USD",
   "date": "latest"
  }
 }
}
```

## 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": [],
     "properties": {
      "to": {
       "type": "string",
       "description": "Comma-separated target currency ISO codes (e.g. 'GBP,JPY,EUR'). Omit to retrieve all available fiat rates."
      },
      "base": {
       "type": "string",
       "description": "Base currency ISO code (e.g. USD, EUR, GBP)"
      },
      "date": {
       "type": "string",
       "description": "Historical date in YYYY-MM-DD format, or 'latest' for real-time rates"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": "USD",
  "date": "2025-01-01",
  "rates": {
   "EUR": 0.92,
   "GBP": 0.78,
   "JPY": 145.2
  },
  "source": "European Central Bank"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibesprings-net-dbf1d3aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibesprings.net](https://www.zero.xyz/host/vibesprings.net/llms.txt)