# Alpha Vantage

> **You are on:** `https://beta-api.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API |
> |---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com |
> | Beta | beta.paywithlocus.com | beta-api.paywithlocus.com |
> | Stage | stage.paywithlocus.com | stage-api.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.

**Category:** Data / Intelligence | **Website:** [www.alphavantage.co](https://www.alphavantage.co) | **Docs:** [www.alphavantage.co/documentation/](https://www.alphavantage.co/documentation/)

## Access Methods

| Method | Base URL | Auth |
|--------|----------|------|
| **MPP (Tempo)** | `https://alphavantage.mpp.paywithlocus.com/alphavantage/` | HTTP 402 auto-payment |
| **Wrapped API** | `https://beta-api.paywithlocus.com/api/wrapped/alphavantage/` | `Authorization: Bearer <LOCUS_API_KEY>` |

**OpenAPI discovery:** `GET https://alphavantage.mpp.paywithlocus.com/openapi.json`

## Endpoints

### Intraday Time Series

Current and 20+ years of historical intraday OHLCV data for a given equity.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol (e.g., "IBM", "AAPL") |
| `interval` | string | Yes | Time interval: 1min, 5min, 15min, 30min, 60min |
| `adjusted` | boolean | No | Return adjusted data (default true) |
| `extended_hours` | boolean | No | Include pre/post-market data (default true) |
| `month` | string | No | Specific month for historical data (YYYY-MM format) |
| `outputsize` | string | No | "compact" (latest 100 points) or "full" (20+ years) |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-intraday \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","interval":"<string>","adjusted":"<boolean>","extended_hours":"<boolean>","month":"<string>","outputsize":"<string>","datatype":"<string>"}'
```

### Daily Time Series

Daily OHLCV time series for a given equity (20+ years of data).

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `outputsize` | string | No | "compact" (latest 100 points) or "full" (20+ years) |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-daily \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","outputsize":"<string>","datatype":"<string>"}'
```

### Weekly Time Series

Weekly OHLCV data for a given equity. Last trading day of each week, 20+ years.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-weekly \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","datatype":"<string>"}'
```

### Monthly Time Series

Monthly OHLCV data for a given equity. Last trading day of each month, 20+ years.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/time-series-monthly \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","datatype":"<string>"}'
```

### Global Quote

Latest price and volume for a single ticker — open, high, low, close, volume, and change.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol (e.g., "IBM") |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/global-quote \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","datatype":"<string>"}'
```

### Symbol Search

Search for matching symbols by keywords. Returns symbol, name, region, currency, and match score.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keywords` | string | Yes | Search keywords (e.g., "microsoft", "SAIC") |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/symbol-search \
  -H "Content-Type: application/json" \
  -d '{"keywords":"<string>","datatype":"<string>"}'
```

### Market Status

Current open/closed status of major trading venues worldwide — equities, forex, and crypto.

**Estimated cost:** $0.008

_No parameters required._

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/market-status \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Top Gainers & Losers

Top 20 gainers, losers, and most actively traded tickers in the US market.

**Estimated cost:** $0.008

_No parameters required._

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/top-gainers-losers \
  -H "Content-Type: application/json" \
  -d '{}'
```

### News Sentiment

Live and historical market news with AI-powered sentiment scores. Filter by tickers and topics.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tickers` | string | No | Comma-separated ticker symbols (e.g., "AAPL,MSFT") |
| `topics` | string | No | Comma-separated topics: blockchain, earnings, ipo, mergers_and_acquisitions, financial_markets, economy_fiscal, economy_monetary, economy_macro, energy_transportation, finance, life_sciences, manufacturing, real_estate, retail_wholesale, technology |
| `time_from` | string | No | Start time in YYYYMMDDTHHMM format (e.g., "20220410T0130") |
| `time_to` | string | No | End time in YYYYMMDDTHHMM format |
| `sort` | string | No | "LATEST", "EARLIEST", or "RELEVANCE" (default "LATEST") |
| `limit` | number | No | Number of results (default 50, max 1000) |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/news-sentiment \
  -H "Content-Type: application/json" \
  -d '{"tickers":"<string>","topics":"<string>","time_from":"<string>","time_to":"<string>","sort":"<string>","limit":"<number>"}'
```

### Earnings Call Transcript

Full earnings call transcript with sentiment signals. Supports 2010Q1 onward.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `quarter` | string | Yes | Quarter in YYYYQN format (e.g., "2024Q1") |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/earnings-call-transcript \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","quarter":"<string>"}'
```

### Company Overview

Company profile — sector, industry, market cap, P/E ratio, dividends, 52-week range, and more.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/company-overview \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Income Statement

Annual and quarterly income statement — revenue, net income, EBITDA, gross profit, etc.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/income-statement \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Balance Sheet

Annual and quarterly balance sheet — total assets, liabilities, equity, cash, and debt.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/balance-sheet \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Cash Flow

Annual and quarterly cash flow statement — operating, investing, and financing activities.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/cash-flow \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Earnings

Annual and quarterly earnings history — reported EPS, estimated EPS, and surprise percentage.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/earnings \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Currency Exchange Rate

Realtime exchange rate for any currency pair (physical or digital).

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_currency` | string | Yes | Source currency code (e.g., "USD", "BTC") |
| `to_currency` | string | Yes | Target currency code (e.g., "EUR", "JPY") |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/currency-exchange-rate \
  -H "Content-Type: application/json" \
  -d '{"from_currency":"<string>","to_currency":"<string>"}'
```

### FX Daily

Daily forex time series (OHLC) for a currency pair.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_symbol` | string | Yes | Source currency code (e.g., "EUR") |
| `to_symbol` | string | Yes | Target currency code (e.g., "USD") |
| `outputsize` | string | No | "compact" (latest 100 points) or "full" |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/fx-daily \
  -H "Content-Type: application/json" \
  -d '{"from_symbol":"<string>","to_symbol":"<string>","outputsize":"<string>","datatype":"<string>"}'
```

### Crypto Exchange Rate

Realtime exchange rate for a cryptocurrency pair (e.g., BTC to USD).

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from_currency` | string | Yes | Source crypto code (e.g., "BTC", "ETH") |
| `to_currency` | string | Yes | Target currency code (e.g., "USD", "EUR") |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/crypto-exchange-rate \
  -H "Content-Type: application/json" \
  -d '{"from_currency":"<string>","to_currency":"<string>"}'
```

### Digital Currency Daily

Daily OHLCV time series for a cryptocurrency, valued in a given market (e.g., BTC in USD).

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Cryptocurrency symbol (e.g., "BTC", "ETH") |
| `market` | string | Yes | Market currency code (e.g., "USD", "EUR") |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/digital-currency-daily \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","market":"<string>"}'
```

### Commodity Price

Historical commodity prices — oil (WTI/Brent), natural gas, metals, and agriculture.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `commodity` | string | Yes | Commodity function: WTI, BRENT, NATURAL_GAS, COPPER, ALUMINUM, WHEAT, CORN, COTTON, SUGAR, COFFEE |
| `interval` | string | No | "daily", "weekly", or "monthly" (default "monthly") |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/commodity-price \
  -H "Content-Type: application/json" \
  -d '{"commodity":"<string>","interval":"<string>","datatype":"<string>"}'
```

### Economic Indicator

US economic indicators — GDP, Treasury yield, CPI, inflation, unemployment, and more.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `indicator` | string | Yes | Indicator function: REAL_GDP, REAL_GDP_PER_CAPITA, TREASURY_YIELD, FEDERAL_FUNDS_RATE, CPI, INFLATION, RETAIL_SALES, DURABLES, UNEMPLOYMENT, NONFARM_PAYROLL |
| `interval` | string | No | "daily", "weekly", "monthly", "quarterly", or "annual" (varies by indicator) |
| `maturity` | string | No | Treasury yield maturity: "3month", "2year", "5year", "7year", "10year", "30year" (TREASURY_YIELD only) |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/economic-indicator \
  -H "Content-Type: application/json" \
  -d '{"indicator":"<string>","interval":"<string>","maturity":"<string>","datatype":"<string>"}'
```

### SMA (Simple Moving Average)

Simple Moving Average technical indicator for a given equity.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `interval` | string | Yes | Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly |
| `time_period` | number | Yes | Number of data points for calculation (e.g., 20, 50, 200) |
| `series_type` | string | Yes | Price type: close, open, high, low |
| `month` | string | No | Specific month (YYYY-MM) for intraday intervals |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/sma \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","interval":"<string>","time_period":"<number>","series_type":"<string>","month":"<string>","datatype":"<string>"}'
```

### EMA (Exponential Moving Average)

Exponential Moving Average technical indicator for a given equity.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `interval` | string | Yes | Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly |
| `time_period` | number | Yes | Number of data points for calculation |
| `series_type` | string | Yes | Price type: close, open, high, low |
| `month` | string | No | Specific month (YYYY-MM) for intraday intervals |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/ema \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","interval":"<string>","time_period":"<number>","series_type":"<string>","month":"<string>","datatype":"<string>"}'
```

### MACD

Moving Average Convergence/Divergence — trend-following momentum indicator.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `interval` | string | Yes | Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly |
| `series_type` | string | Yes | Price type: close, open, high, low |
| `fastperiod` | number | No | Fast period (default 12) |
| `slowperiod` | number | No | Slow period (default 26) |
| `signalperiod` | number | No | Signal period (default 9) |
| `month` | string | No | Specific month (YYYY-MM) for intraday intervals |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/macd \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","interval":"<string>","series_type":"<string>","fastperiod":"<number>","slowperiod":"<number>","signalperiod":"<number>","month":"<string>","datatype":"<string>"}'
```

### RSI (Relative Strength Index)

Relative Strength Index — momentum oscillator measuring speed and change of price movements.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `interval` | string | Yes | Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly |
| `time_period` | number | Yes | Number of data points (e.g., 14) |
| `series_type` | string | Yes | Price type: close, open, high, low |
| `month` | string | No | Specific month (YYYY-MM) for intraday intervals |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/rsi \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","interval":"<string>","time_period":"<number>","series_type":"<string>","month":"<string>","datatype":"<string>"}'
```

### Bollinger Bands

Bollinger Bands — volatility bands placed above and below a moving average.

**Estimated cost:** $0.008

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol |
| `interval` | string | Yes | Time interval: 1min, 5min, 15min, 30min, 60min, daily, weekly, monthly |
| `time_period` | number | Yes | Number of data points (e.g., 20) |
| `series_type` | string | Yes | Price type: close, open, high, low |
| `nbdevup` | number | No | Standard deviations for upper band (default 2) |
| `nbdevdn` | number | No | Standard deviations for lower band (default 2) |
| `matype` | number | No | Moving average type: 0=SMA, 1=EMA, 2=WMA, 3=DEMA, 4=TEMA, 5=TRIMA, 6=T3, 7=KAMA, 8=MAMA (default 0) |
| `month` | string | No | Specific month (YYYY-MM) for intraday intervals |
| `datatype` | string | No | "json" (default) or "csv" |

```bash
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/bbands \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>","interval":"<string>","time_period":"<number>","series_type":"<string>","nbdevup":"<number>","nbdevdn":"<number>","matype":"<number>","month":"<string>","datatype":"<string>"}'
```