Endpoints

Tickers

Current state for one or many tickers. Returns the entire row as documented on the schema page: identification, price context, volume, technicals, fundamentals, and every flag. For history, use /signals; for universe-wide queries, use /scan.

One ticker

GET/v1/tickers/{ticker}

Get the full current state of one ticker.

Returns the entire ticker row — every field on the schema, including current values for all numeric signals and the current value of every boolean flag. This is what the schema page documents, served as one JSON object. Treat it as the authoritative current snapshot for a symbol.

Authentication required
Path parameters
NameInTypeRequiredDescription
tickerpathstringrequired
Ticker symbol. Case-insensitive. Equities: exchange symbol (`AAPL`). Crypto: bare symbol (`BTC`).
Example: AAPL
Responses
StatusDescription
200Full ticker object. See the schema page for every field.
404Ticker not tracked.

Snapshot for AAPL

Request
curl https://api.tickerbot.io/v1/tickers/AAPL \
  -H "Authorization: Bearer YOUR_KEY"
Response · 200
{
  "ticker": "AAPL",
  "name": "Apple Inc.",
  "asset_type": "equity",
  "exchange": "NASDAQ",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "country": "US",
  "active": true,
  "as_of": "2026-04-30T14:32:11Z",

  "price": 187.42,
  "previous_close": 184.10,
  "session_open": 185.20,
  "session_high": 187.95,
  "session_low": 184.85,
  "day_change": 3.32,
  "day_change_pct": 1.80,
  "gap_pct": 0.60,
  "premarket_price": 184.95,
  "afterhours_price": null,

  "volume_today": 42120500,
  "avg_volume_10d": 38500000,
  "avg_volume_30d": 41200000,
  "relative_volume": 1.09,
  "day_dollar_volume": 7896849234,
  "day_vwap": 186.40,

  "high_52w": 199.62,
  "low_52w": 165.10,
  "high_20d": 188.50,
  "low_20d": 178.30,
  "days_since_52w_high": 12,
  "days_since_52w_low": 88,

  "pct_from_52w_high": 6.11,
  "pct_from_52w_low": 13.52,
  "position_in_52w_range": 65.2,
  "pct_from_sma_50": 2.40,
  "pct_from_sma_200": 5.05,
  "pct_from_vwap": 0.55,

  "atr_14": 3.42,
  "atr_percent": 1.83,
  "bollinger_pct_b": 0.78,

  "sma_10": 184.20, "sma_20": 182.50, "sma_50": 183.05, "sma_200": 178.42,
  "rsi_14": 58.4,
  "macd_line": 1.20, "macd_signal": 0.85, "macd_histogram": 0.35,
  "bollinger_upper": 190.50, "bollinger_lower": 175.20,

  "market_cap": 2900000000000,
  "pe_ratio": 31.5,
  "eps": 5.95,
  "dividend_yield": 0.0051,
  "beta": 1.24,
  "float_shares": 15400000000,
  "shares_outstanding": 15470000000,

  "earnings_date": "2026-05-02",
  "days_to_earnings": 2,
  "ex_dividend_date": "2026-05-12",

  "flags": {
    "above_sma_10": true,
    "above_sma_20": true,
    "above_sma_50": true,
    "above_sma_200": true,
    "above_vwap": true,
    "macd_above_signal": true,
    "in_uptrend": true,
    "in_downtrend": false,
    "at_52w_high": false,
    "approaching_52w_high": false,
    "rsi_overbought": false,
    "rsi_oversold": false,
    "volume_unusual_2x": false,
    "breakout": false,
    "earnings_this_week": true,
    "mega_cap": true
  }
}

Try this with your account →

Multiple tickers in one call

Comma-separated symbols, capped at 100. Same payload shape, returned as an array.

GET/v1/tickers

Get the current state of multiple tickers in one round trip.

Same payload shape as `/v1/tickers/{ticker}`, but returned as an array under `data`. Capped at 100 tickers per request. Use this when you’re tracking a small named set and want them all at once instead of one HTTP call per symbol.

Authentication required
Query parameters
NameInTypeRequiredDescription
tickersquerystring (comma-separated)required
Up to 100 ticker symbols, comma-separated. Case-insensitive. Order is preserved in the response.
Example: NVDA,TSLA,JPM
Responses
StatusDescription
200Array of ticker objects in the order requested. Unknown symbols are silently skipped — check the count.
400More than 100 tickers requested.

Three tickers in one call

Request
curl "https://api.tickerbot.io/v1/tickers?tickers=NVDA,TSLA,JPM" \
  -H "Authorization: Bearer YOUR_KEY"
Response · 200
{
  "as_of": "2026-04-30T14:32:11Z",
  "requested": 3,
  "returned": 3,
  "data": [
    { "ticker": "NVDA", "name": "NVIDIA",       "price": 1124.30, "day_change_pct": 2.41,  "...": "(full object)" },
    { "ticker": "TSLA", "name": "Tesla",        "price":  248.20, "day_change_pct": -0.85, "...": "(full object)" },
    { "ticker": "JPM",  "name": "JPMorgan Chase","price":  198.40, "day_change_pct": 0.62,  "...": "(full object)" }
  ]
}