# Alpha Vantage Currency Exchange Rate (via Locus x402)

> Alpha Vantage Currency Exchange Rate (via Locus x402) is a paid API for AI agents from alphavantage.x402.paywithlocus.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-13).

Returns the real-time exchange rate between any two currencies, including fiat, crypto, and commodities, via a pay-per-call x402 micropayment gateway.

## Facts

- Endpoint: POST https://alphavantage.x402.paywithlocus.com/alphavantage/currency-exchange-rate
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alpha-vantage-currency-exchange-rate-via-locus-x402-2f50e10e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_esj8yRFp-wQ741u2DM2t2

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 alpha-vantage-currency-exchange-rate-via-locus-x402-2f50e10e -d '<json body>'
```

Example prompt: What is the current exchange rate from USD to EUR? I need the live Alpha Vantage quote.

## When to prefer this

Choose this endpoint when you need a real-time, point-in-time exchange rate between two currencies (fiat, crypto, or commodity) and want to pay only per call without a subscription. It is ideal for agents performing on-demand currency conversion, pricing calculations, or financial data enrichment in workflows where subscribing to a full forex data plan is unnecessary.

## Known failure modes

- Invalid currency code returns an error or empty data object
- Unsupported currency pair may return no rate
- Payment failure or insufficient USDC balance prevents the call from completing
- Rate-limited or unavailable Alpha Vantage data results in empty or delayed response
- Malformed request body (missing from_currency or to_currency) returns a validation error

## How this service works

Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.

## Output

Returns a JSON object containing the real-time exchange rate between the specified currency pair, including the from and to currency names and codes, the exchange rate, bid price, ask price, and the timestamp of the last data refresh. Payment metadata (settled USDC, authorized USDC) and a request ID are also included in the response envelope.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to_currency": {
   "type": "string"
  },
  "from_currency": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-currency-exchange-rate-via-locus-x402-2f50e10e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alphavantage.x402.paywithlocus.com](https://www.zero.xyz/host/alphavantage.x402.paywithlocus.com/llms.txt)