Real-time and historical currency exchange rates via Alpha Vantage, pay-per-call over MPP.
What it does
This endpoint provides real-time currency exchange rate lookups powered by Alpha Vantage data, accessible through the Locus MPP (Micropayment Protocol). Send a POST request with a source currency code (e.g., "USD", "BTC") and a target currency code (e.g., "EUR", "JPY") to receive the current exchange rate. Payment is settled per-call via the Tempo method on pathUSD.
The endpoint is part of a broader Alpha Vantage MPP service that exposes 26+ financial data endpoints including stock time series (intraday, daily, weekly, monthly), forex rates, crypto prices, commodity prices, economic indicators (GDP, CPI, unemployment, etc.), company fundamentals (income statement, balance sheet, cash flow, earnings), news sentiment, technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands), and more. Each call costs 8,000 base units of pathUSD (6 decimals), which equals $0.008 per request.
The request body requires two fields: `from_currency` (source currency code) and `to_currency` (target currency code). Both fiat ISO codes and cryptocurrency symbols are supported. The response format follows Alpha Vantage's standard JSON structure. The OpenAPI spec is available at the service root and full Alpha Vantage documentation is referenced at https://www.alphavantage.co/documentation/.
Capabilities
Use cases
- —Fetching the current exchange rate between two fiat currencies (e.g., USD to EUR) for a trading bot
- —Looking up a crypto-to-fiat rate (e.g., BTC to USD) in an agent workflow
- —Building a multi-currency pricing engine that needs on-demand FX rates
- —Monitoring currency pair movements as part of an automated financial analysis pipeline
Fit
Best for
- —AI agents needing on-demand FX rates without API key management
- —Pay-per-call currency lookups with no subscription commitment
- —Programmatic access to Alpha Vantage exchange rate data via micropayments
Not for
- —High-frequency streaming FX data (this is a per-call charge model)
- —Historical FX time series (use the /fx-daily endpoint instead)
- —Free or bulk-rate currency data needs
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/currency-exchange-rate \
-H "Content-Type: application/json" \
-d '{"from_currency": "USD", "to_currency": "EUR"}'Example
Request
{
"to_currency": "EUR",
"from_currency": "USD"
}Endpoint
Quality
Full OpenAPI schema with clear request body and payment info is available. However, the probe did not capture a 402 challenge (HEAD/GET returned 404; the endpoint requires POST), no example response is available, and crawled pages all returned generic 404 JSON. Price is clearly derivable from the spec. Docking points for missing live 402 confirmation and absent response schema.
Warnings
- —Probe returned 404 on HEAD and GET — endpoint likely only responds to POST requests, so liveness could not be confirmed via the probe methods used.
- —No response schema is documented; the actual response structure must be inferred from Alpha Vantage's own documentation.
- —Currency token address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo method context; this is not explicitly confirmed in the spec.
Citations
- —The endpoint accepts POST with from_currency and to_currency fieldshttps://alphavantage.mpp.paywithlocus.com
- —Each call costs 8000 base units via Tempo methodhttps://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage provides financial market data including forex, crypto, commodities, and economic indicatorshttps://www.alphavantage.co/documentation/"
- —Full API reference is available at alphavantage.co/documentationhttps://www.alphavantage.co/documentation/"
- —LLM-specific docs referenced at beta.paywithlocus.com/mpp/alphavantage.mdhttps://beta.paywithlocus.com/mpp/alphavantage.md