Daily foreign exchange (FX) time series data via Alpha Vantage, paid per call over MPP/Tempo.
What it does
This endpoint provides daily forex (FX) time series data for any currency pair through Alpha Vantage's market data service, proxied via the Locus MPP (Micropayment Protocol) gateway. You POST a JSON body specifying `from_symbol` and `to_symbol` (e.g., EUR → USD) and receive daily open/high/low/close exchange rate data. Optional parameters let you choose between compact output (latest 100 data points) or full historical data, and select JSON or CSV format.
The endpoint is part of a broader Alpha Vantage suite hosted on the Locus MPP gateway that includes 25+ endpoints covering stock time series (intraday through monthly), global quotes, symbol search, news sentiment, earnings call transcripts, company fundamentals (overview, income statement, balance sheet, cash flow, earnings), crypto and commodity prices, economic indicators, and technical analysis indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Each call costs 8,000 base units of pathUSD on Tempo L2 (approximately $0.008 per request, assuming pathUSD uses 6 decimals). Payment is handled via the MPP charge intent — each request is a one-shot micropayment.
The endpoint accepts POST requests with a JSON body. The probe did not return a 402 challenge on HEAD/GET (it returned 404), which is expected since the OpenAPI spec defines only POST. The OpenAPI schema is well-documented with clear parameter descriptions and required fields.
Capabilities
Use cases
- —Retrieving historical daily exchange rates for backtesting forex trading strategies
- —Building dashboards that display daily currency pair movements over time
- —Feeding FX data into financial models or risk calculations
- —Comparing currency performance across different time horizons
- —Automating daily FX data collection for reporting pipelines
Fit
Best for
- —Agents or apps needing on-demand daily FX OHLC data without API key management
- —Micropayment-based access to Alpha Vantage without a subscription
- —Programmatic forex data retrieval settled via crypto micropayments
Not for
- —Real-time or tick-level FX streaming (this is daily granularity only)
- —High-volume bulk data downloads where a direct Alpha Vantage subscription would be cheaper
- —Users who cannot settle payments on Tempo L2
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/fx-daily \
-H "Content-Type: application/json" \
-d '{"from_symbol": "EUR", "to_symbol": "USD", "outputsize": "compact"}'Example
Request
{
"datatype": "json",
"to_symbol": "USD",
"outputsize": "compact",
"from_symbol": "EUR"
}Endpoint
Quality
Full OpenAPI schema with clear parameter definitions and pricing metadata is available. However, the probe returned 404 on HEAD/GET (POST-only endpoint, so not necessarily broken), no actual 402 challenge was captured, no example response is available, and crawled pages returned only generic 'not found' messages. Price is inferred from x-payment-info but the currency token's decimals are assumed (6), not confirmed.
Warnings
- —Probe did not capture a 402 MPP challenge — endpoint only accepts POST, so HEAD/GET returned 404. Liveness via POST is unconfirmed.
- —pathUSD decimals assumed to be 6; actual price per call (~$0.008) may differ if the token uses different decimals.
- —No example response data available from probe or crawl; response schema is undocumented beyond '200: Successful response'.
- —Currency token address 0x20c000000000000000000000b9537d11c60e8b50 not independently verified.
Citations
- —The FX Daily endpoint accepts POST with from_symbol, to_symbol, outputsize, and datatype parametershttps://alphavantage.mpp.paywithlocus.com
- —Each call costs 8000 base units of pathUSD on Tempo L2 with charge intenthttps://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage provides financial market data including stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentimenthttps://www.alphavantage.co/documentation/,
- —Additional documentation available at the Locus LLM docs pagehttps://beta.paywithlocus.com/mpp/alphavantage.md