# GET /api/mcp/data/stock/{ticker}

> What is NVDA trading at and what company is it?

A small payload with the live price, company name, sector, industry, market cap, volume, beta and the next earnings date when known.

- **Family:** Options chain (https://apexvol.com/developers/options-chain-api)
- **Plan:** Basic and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** price is dollars. market_cap, volume and beta are returned as formatted strings.
- **Basis:** price is the mid of the nearest-expiration parity quote from the options feed, not an exchange last. No bid or ask in this payload.
- **MCP tools:** `get_stock_price`
- **Background:** https://apexvol.com/learn/what-is-a-stock

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/stock/NVDA"
```

## Response (captured 2026-09-08)

Real response, lists cut to the rows nearest the money. The envelope is `{"success": true, "data": ...}`.

```json
{
  "success": true,
  "data": {
    "beta": "1.93",
    "company_name": "NVIDIA Corporation",
    "earnings_date": null,
    "industry": "Technology",
    "market_cap": "$5.56T",
    "price": 230.3,
    "sector": "Technology",
    "volume": "6,443,150"
  }
}
```

## Fields

- `price`: Live mid price.
- `company_name, sector, industry`: Identity from the coverage registry.
- `market_cap, volume, beta`: Formatted strings.
- `earnings_date`: Next report when the feed has one.

## Errors

- `401`: no or revoked token
- `429`: Retry-After seconds
- `424`: data feed unavailable, retry
- Full list: https://apexvol.com/developers/errors

## Ask it in an MCP client

- What is NVDA trading at?
- Give me AAPL's price, sector and market cap.
- Which sector is AMD in?

Conventions for units, bases and timestamps: https://apexvol.com/developers/conventions