Pay-per-call commodity price data (WTI, Brent, natural gas, metals, agriculture) via Alpha Vantage.
What it does
This endpoint provides historical and current commodity price data sourced from Alpha Vantage, served through the Locus MPP (Micropayment Protocol) gateway. It supports ten commodity types: WTI crude oil, Brent crude oil, natural gas, copper, aluminum, wheat, corn, cotton, sugar, and coffee. Data can be retrieved at daily, weekly, or monthly intervals and returned in JSON or CSV format.
The endpoint is part of a broader Alpha Vantage suite hosted on the Locus MPP platform that includes 25+ financial data endpoints covering stock time series (intraday through monthly), forex rates, cryptocurrency prices, economic indicators (GDP, CPI, unemployment, treasury yields), fundamental data (income statements, balance sheets, cash flow, earnings), technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands), news sentiment, and more. Each endpoint is priced at 8,000 base units of pathUSD on Tempo L2, which equals $0.008 (less than one cent) per call.
Payment is handled via the MPP wire protocol: the endpoint returns a 402 challenge on unauthenticated requests, and agents settle per-call charges in pathUSD on Tempo. The endpoint accepts POST requests with a JSON body. The only required field is `commodity` (e.g., "WTI", "COPPER", "WHEAT"); optional fields include `interval` (defaults to monthly) and `datatype` (defaults to JSON). Full API reference is available at Alpha Vantage's documentation site.
Capabilities
Use cases
- —Retrieving historical crude oil prices for energy market analysis
- —Monitoring agricultural commodity trends (wheat, corn, coffee) for supply-chain planning
- —Building dashboards that track metal prices (copper, aluminum) over time
- —Feeding commodity price series into quantitative trading models
- —Comparing energy commodity prices across daily, weekly, and monthly granularities
Fit
Best for
- —AI agents needing on-demand commodity price lookups without API key management
- —Low-volume, pay-per-call access to Alpha Vantage commodity data
- —Automated pipelines that need structured JSON commodity time series
Not for
- —High-frequency or streaming commodity price feeds (this is request-response only)
- —Commodities not in the supported list (e.g., precious metals like gold/silver are not listed for this endpoint)
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/commodity-price \
-H "Content-Type: application/json" \
-d '{"commodity": "WTI", "interval": "monthly"}'Example
Request
{
"datatype": "json",
"interval": "monthly",
"commodity": "WTI"
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and payment info is available. However, the probe did not capture a live 402 challenge (HEAD/GET returned 404; the endpoint requires POST), no example response is documented, and crawled pages returned only generic 404 messages. Price and schema are well-defined but response format must be inferred from Alpha Vantage's upstream docs.
Warnings
- —Probe returned 404 on HEAD/GET — endpoint is POST-only; liveness via POST was not confirmed by the probe
- —No example response schema is provided in the OpenAPI spec
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD (6 decimals) based on the Tempo method; if decimals differ, the $0.008 price would be incorrect
Citations
- —The endpoint supports commodities: WTI, BRENT, NATURAL_GAS, COPPER, ALUMINUM, WHEAT, CORN, COTTON, SUGAR, COFFEEhttps://alphavantage.mpp.paywithlocus.com
- —Each call costs 8000 base units via Tempo method with the listed currency addresshttps://alphavantage.mpp.paywithlocus.com
- —Full Alpha Vantage API reference is available at alphavantage.co/documentationhttps://www.alphavantage.co/documentation/,
- —LLM-oriented docs are referenced at https://beta.paywithlocus.com/mpp/alphavantage.mdhttps://beta.paywithlocus.com/mpp/alphavantage.md