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

> What is in the raw analytics row the platform screens NVDA on?

Returns the data feed's analytics row: IV summaries, IV and HV statistics, slope and contango, earnings-move components, borrow rates, betas and percentiles. Defaults to the curated 45-field subset the platform screens on; ask for specific fields or all.

- **Family:** Stock analytics (https://apexvol.com/developers/stock-analytics-api)
- **Plan:** Pro and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** Vendor units: IVs and HVs in percentage points, price changes in percentage points, borrow in percent, market cap in dollars. The row contains a numeric field named error, a model-fit statistic, not a failure.
- **Basis:** Vendor field names are returned as-is (iv30d, clsHv20d, ivPctile1y, slope, contango and so on).
- **MCP tools:** `get_orats_cores`
- **Background:** https://apexvol.com/learn/options-data-api

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `ticker` (required) | path |  | any covered symbol | The underlying, upper case. Use /search to check coverage. |
| `fields` | query | curated subset | CSV of field names, or all | Which fields to return. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/cores/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": {
    "absAvgErnMv": 5.561,
    "assetType": 3,
    "atmIvM1": 32.01,
    "atmIvM2": 33.46,
    "atmIvM3": 37.99,
    "atmIvM4": 37.7,
    "available_field_count": 340,
    "avgOptVolu20d": 3290792.75,
    "beta1m": 3.08,
    "beta1y": 1.93,
    "borrow2yr": 3.32,
    "borrow30": 3.42,
    "cOi": 8454385,
    "cVolu": 3549509,
    "clsHv20d": 44.92,
    "clsHvXern20d": 33.94,
    "contango": 1.26,
    "correlSpy1m": 0.49,
    "correlSpy1y": 0.41,
    "daysToNextErn": 0,
    "divYield": 0.4,
    "dlt25Iv30d": 32.6,
    "dlt75Iv30d": 34.55,
    "dtExM1": 15,
    "dtExM2": 43,
    "dtExM3": 78,
    "dtExM4": 106,
    "ernMvStdv": 4.4168,
    "exErnIv30d": 33.05,
    "impErnMv": 7.82,
    "impliedEarningsMove": 6,
    "iv30d": 33.05,
    "iv60d": 35.83,
    "ivHvXernRatio": 1.03,
    "ivHvXernRatio1y": 0.9,
    "ivHvXernRatioStdv1y": 6.49,
    "ivPctile1y": 12,
    "ivSpyRatio": 2.7984,
    "ivSpyRatioAvg1y": 2.37,
    "mktCap": 5561054100,
    "nextErn": "0000-00-00",
    "orHv20d": 37.86,
    "pOi": 7571013,
    "pVolu": 1906366,
    "pxCls": 228.45,
    "sectorName": "Technology",
    "slope": 1.2147,
    "slopeavg1y": 2.1043,
    "slopepctile": 25.79,
    "stkPxChng1m": 5.05,
    "stkPxChng1wk": 5.86,
    "stkVolu": 6443150,
    "ticker": "NVDA",
    "tkOver": 0,
    "tradeDate": "2026-09-04"
  }
}
```

## Fields

- `iv30d, iv60d, ivPctile1y, exErnIv30d`: IV summaries.
- `clsHv20d, orHv20d, ivHvXernRatio`: Realized vol and the ratio.
- `slope, contango, dlt25Iv30d, dlt75Iv30d`: Skew and term.
- `impErnMv, absAvgErnMv, nextErn, daysToNextErn`: Earnings.
- `borrow30, beta1y, correlSpy1y, mktCap`: The rest.

## Errors

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

## Ask it in an MCP client

- Pull the cores row for NVDA.
- Give me iv30d, clsHv20d and slope for AAPL from cores.
- What is exErnIv30d versus iv30d on TSLA?

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