Real-time cryptocurrency exchange rates via Alpha Vantage, pay-per-call over MPP/Tempo.
What it does
This endpoint provides real-time cryptocurrency exchange rate lookups powered by Alpha Vantage, accessed through the Locus MPP (Micropayment Protocol) gateway. Send a POST request with a source crypto code (e.g., "BTC", "ETH") and a target currency code (e.g., "USD", "EUR") 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 suite hosted on the Locus MPP platform, which also exposes stock time series (intraday, daily, weekly, monthly), forex rates, commodity prices, economic indicators, technical analysis (SMA, EMA, MACD, RSI, Bollinger Bands), news sentiment, earnings call transcripts, and fundamental data (company overview, income statement, balance sheet, cash flow, earnings). All endpoints share the same pricing of 8,000 base units of pathUSD per call, which equals $0.008 (less than one cent) per request assuming pathUSD uses 6 decimals.
The endpoint accepts POST requests with a JSON body containing required fields "from_currency" and "to_currency". The OpenAPI spec is well-defined. Note that the probe returned 404 on HEAD and GET methods, which is expected since the endpoint only accepts POST. The OpenAPI schema confirms POST as the intended method, and the 402 payment challenge is documented in the spec's x-payment-info metadata.
Capabilities
Use cases
- —Fetching the current BTC/USD or ETH/EUR exchange rate for a trading bot
- —Displaying live crypto prices in a portfolio dashboard
- —Converting cryptocurrency values to fiat for accounting or reporting
- —Powering an AI agent that answers questions about current crypto prices
- —Building alerts that trigger when a crypto crosses a price threshold
Fit
Best for
- —Agents needing on-demand crypto-to-fiat exchange rates without API key management
- —Pay-per-call access to Alpha Vantage without a subscription
- —Lightweight single-pair crypto price lookups
Not for
- —High-frequency trading requiring sub-second WebSocket streams
- —Bulk historical cryptocurrency OHLCV data (use the digital-currency-daily endpoint instead)
- —Free-tier users who want zero-cost access
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/crypto-exchange-rate \
-H "Content-Type: application/json" \
-d '{"from_currency": "BTC", "to_currency": "USD"}'Example
Request
{
"to_currency": "USD",
"from_currency": "BTC"
}Endpoint
Quality
Full OpenAPI schema with clear request body and payment info is available. However, the probe did not capture a live 402 challenge (only 404 on HEAD/GET, expected for POST-only), no example response is available, and crawled pages returned only 404 error JSON. Price is documented in x-payment-info but the currency token address makes exact denomination slightly uncertain.
Warnings
- —Probe returned 404 on HEAD and GET; endpoint is POST-only so liveness could not be confirmed via the probe's methods
- —No example response body is available in the OpenAPI spec or crawl data
- —Currency token address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals; if decimals differ, the $0.008 price estimate would be wrong
- —All crawled documentation pages returned 404; refer to https://www.alphavantage.co/documentation/ and https://beta.paywithlocus.com/mpp/alphavantage.md for docs
Citations
- —Endpoint accepts POST with from_currency and to_currency fieldshttps://alphavantage.mpp.paywithlocus.com
- —Payment amount is 8000 base units via Tempo methodhttps://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/,
- —Documentation available at alphavantage.co and Locus MPP skill filehttps://beta.paywithlocus.com/mpp/alphavantage.md