# GET /v2/tickers/{ticker}

**Live 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` — a `YYYY-MM-DD` date for the row at the close of that day, or a full ISO timestamp for the row at that intraday moment — see the dedicated [as-of snapshot](/docs/endpoints/tickers/asof) page for frozen-fields and coverage semantics.

## Plan access

- **Plan access.** Included on every plan, Free through Enterprise.
- **Rate limit.** Hobby 600/min · Pro 6,000/min · Scale 60,000/min.
- **Universe.** All 14,399+ 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: X-prefixed pair (`X:BTCUSD`) — bare `BTC`/`ETH` are US-listed ETFs, not spot crypto. Example: `AAPL`. |
| `asof` | query | string | no | Optional. A `YYYY-MM-DD` date returns the row at the close of that day; a full ISO timestamp returns the row at that moment — minute-level where available; `_meta.resolution` reports the granularity served (minute, hourly, or daily). One staleness rule across the whole asof surface: the row must be within the tier's staleness window (14 days for daily) or the ticker 404s with `last_available` — asof answers "the state AT that instant"; for "last known state" read `/history/1d?limit=1`. Plan window: Free reaches back 30 days; every paid plan is unlimited (`403 asof_tier_required` beyond the window). Coverage note: price, technical indicators, and financial-statement fields reconstruct to the exact date; a few vendor-sourced fields (`forward_pe`, `short_interest`, ownership %, analyst estimates) are populated forward-only and may be `null` in older snapshots while historical backfill is in progress — a `null` there means "not yet backfilled," not "no value existed." Example: `2026-06-16`. |

## 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": 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": false,
    "earnings_this_week": false,
    "...": "(every other column on the schema page)"
  }
}
```

---

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