Retrieve company overview fundamentals for any stock ticker via Alpha Vantage, paid per call on Tempo L2.
What it does
This MPP endpoint exposes Alpha Vantage's Company Overview function through the Locus payment proxy. Send a POST request with a stock ticker symbol and receive fundamental data for that company — including description, sector, industry, market capitalization, P/E ratio, EPS, dividend yield, 52-week range, and other key financial metrics. Payment is settled per-call via the Tempo L2 method at $0.008 per request (8,000 base units of pathUSD, which has 6 decimals).
The endpoint is part of a broader Alpha Vantage suite hosted on the same Locus MPP gateway, which includes 25+ additional endpoints covering intraday/daily/weekly/monthly time series, global quotes, symbol search, news sentiment, earnings call transcripts, income statements, balance sheets, cash flow, earnings, forex, crypto, commodities, economic indicators, and technical analysis (SMA, EMA, MACD, RSI, Bollinger Bands). All sibling endpoints share the same $0.008 per-call pricing.
The request schema is minimal: only a "symbol" field (string, required) is needed. The endpoint accepts POST requests with a JSON body. Response schema details are not documented in the OpenAPI spec, but Alpha Vantage's upstream API documentation at https://www.alphavantage.co/documentation/ describes the full response structure. Note that the probe returned 404 on HEAD and GET — this endpoint only responds to POST requests, which is consistent with the OpenAPI spec declaring only a POST method.
Capabilities
Use cases
- —Retrieve fundamental data (market cap, P/E, EPS, sector) for a given stock ticker
- —Feed company overview data into an AI agent's financial analysis pipeline
- —Enrich a portfolio tracker with per-company fundamental metrics
- —Screen stocks by sector, industry, or valuation ratios
- —Build automated research reports combining company overviews with price data
Fit
Best for
- —AI agents needing on-demand company fundamentals without managing API keys
- —Pay-per-call access to Alpha Vantage without a subscription
- —Programmatic equity research and screening workflows
Not for
- —High-frequency or bulk data pulls where per-call pricing becomes expensive
- —Real-time streaming price data (this returns static fundamental snapshots)
- —Users who already hold an Alpha Vantage API key and prefer direct access
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/company-overview \
-H "Content-Type: application/json" \
-d '{"symbol": "IBM"}'Example
Request
{
"symbol": "IBM"
}Endpoint
Quality
Full OpenAPI schema with clear request parameters and payment info is available, but the probe did not capture a live 402 challenge (only POST is accepted, probe tried HEAD/GET). No response schema or example response is documented. Crawled pages all returned generic 404 JSON, providing no additional documentation.
Warnings
- —Probe returned 404 on HEAD and GET; endpoint only accepts POST per the OpenAPI spec — likely live but not confirmed via 402 challenge
- —No response schema documented in the OpenAPI spec; consumers must refer to upstream Alpha Vantage docs for response structure
- —Currency address 0x20c000000000000000000000b9537d11c60e8b50 is assumed to be pathUSD with 6 decimals based on the Tempo settlement method; if this assumption is wrong the price calculation ($0.008) would be incorrect
Citations
- —The endpoint accepts POST with a required 'symbol' field and charges 8000 base units via Tempo methodhttps://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage provides company overview data including financial fundamentalshttps://www.alphavantage.co/documentation/following
- —Full API reference for Alpha Vantage upstreamhttps://www.alphavantage.co/documentation/following
- —LLM-oriented docs available at Locushttps://beta.paywithlocus.com/mpp/alphavantage.md