# GET /v2/tickers/{ticker}

**Get one ticker**

Returns the entire ticker row. Every field on the schema page, including current values for all numeric signals and the current value of every boolean flag. Pass `?asof=YYYY-MM-DD` to return the row exactly as it was at the close of that day — see the dedicated [as-of snapshot](/docs/endpoints/tickers/history) page for plan-gating, frozen-fields semantics, and the 14-day lookback fallback.

## Plan access

- **Plan access.** Included on every plan, Hobby through Enterprise.
- **Rate limit.** Hobby 600/min · Pro 2,000/min · Scale 10,000/min.
- **Universe.** All ~12,000 tracked tickers on every plan.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `ticker` | path | string | yes | Ticker symbol. Case-insensitive. Equities: exchange symbol (`AAPL`). Crypto: bare symbol (`BTC`). Example: `AAPL`. |
| `asof` | query | string | no | Optional. Returns the row as it was at the close of the given `YYYY-MM-DD` (or full ISO). Sourced from `signal_daily_state`. All paid plans get full history. Example: `2024-01-22`. |

## Status codes

- **200** — The full ticker row under `data`. When `?asof=` is set, the response also carries `_meta.frozen_fields` listing the static columns (name, sector, industry, asset_type, exchange) that reflect current values rather than historical.
- **400** — Invalid ticker format or malformed `asof`.
- **401** — Missing or invalid API key.
- **404** — Ticker not tracked, or no historical row at or before the requested date.

## Sample response

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "ticker": "AAPL",
  "data": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "asset_type": "CS",
    "exchange": "XNAS",
    "country": "us",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "market_cap": 4329832548800,
    "price": 298.74,
    "day_change_pct": 0.0153,
    "gap_pct": 0.0008,
    "volume_today": 42120500,
    "avg_volume_10d": 51983000,
    "relative_volume": 0.81,
    "pe_ratio": 32.4,
    "eps": 9.21,
    "shares_outstanding": 14490000000,
    "high_52w": 312.10,
    "low_52w": 198.43,
    "rsi_14": 73.21,
    "above_sma_50": true,
    "above_sma_200": true,
    "golden_cross_today": false,
    "earnings_this_week": false,
    "...": "(every other column on the schema page)"
  }
}
```

## Examples

### Fetch AAPL

Request:

```shell
curl "https://api.tickerbot.io/v2/tickers/AAPL" \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "ticker": "AAPL",
  "data": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "asset_type": "CS",
    "exchange": "XNAS",
    "country": "us",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "market_cap": 4329832548800,
    "price": 298.74,
    "day_change_pct": 0.0153,
    "gap_pct": 0.0008,
    "volume_today": 42120500,
    "avg_volume_10d": 51983000,
    "relative_volume": 0.81,
    "pe_ratio": 32.4,
    "eps": 9.21,
    "shares_outstanding": 14490000000,
    "high_52w": 312.10,
    "low_52w": 198.43,
    "rsi_14": 73.21,
    "above_sma_50": true,
    "above_sma_200": true,
    "golden_cross_today": false,
    "earnings_this_week": false,
    "...": "(every other column on the schema page)"
  }
}
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/docs/endpoints/tickers/get