View as markdown
Concepts › Signals › Price › Session levels & position

session_high

Highest trade so far today.

Watch this signal live on real tickers: Open in Explore →

At a glance

Typenumeric
GroupPrice
CategorySession levels & position
UnitUSD
Update cadence1 min · mkt hrs
Intervals1m/1h/1d
Universeall tickers
Historyfull · since 2003
Nullableyes — NULL where not applicable

Today's session levels (open, high, low) and where price sits relative to them and yesterday's landmarks.

Query it

Every applicable form factor, grouped by endpoint family. Swap YOUR_KEY for the value from /dashboard/keys. Response payloads are real captures, sampled 2026-08-18 and trimmed — your run's values and dates will differ.

Use signals /v2/signals/{signal}

One signal across the market: who matches now, who matched then, and a push when someone starts. Docs →

Live — every ticker with session_high above a cutoff
curl -G "https://api.tickerbot.io/v2/signals/session_high" \
  --data-urlencode "condition=> 465.901" \
  -H "Authorization: Bearer YOUR_KEY"
Response (sampled 2026-08-18, trimmed)
{
 "as_of": "2026-08-18T00:25:46.005Z",
 "signal": "session_high",
 "condition": "> 465.901",
 "universe": null,
 "count": 2,
 "results": [
  {
   "ticker": "BRK.A",
   "name": "Berkshire Hathaway Inc.",
   "value": 755732.15
  },
  {
   "ticker": "NVR",
   "name": "NVR, Inc.",
   "value": 6333.34
  }
 ]
}
As-of — the same read at a past date
curl -G "https://api.tickerbot.io/v2/signals/session_high" \
  --data-urlencode "condition=> 465.901" \
  -d "asof=2026-05-20" \
  -H "Authorization: Bearer YOUR_KEY"
Response (sampled 2026-08-18, trimmed)
{
 "as_of": "2026-05-20",
 "signal": "session_high",
 "condition": "> 465.901",
 "universe": null,
 "count": 2,
 "results": [
  {
   "ticker": "R:EFFR",
   "name": "Effective Federal Funds Rate",
   "value": null
  },
  {
   "ticker": "R:FFLOWER",
   "name": "Fed Funds Target Range — Lower Bound",
   "value": null
  }
 ]
}
Subscribe — webhook when a ticker starts matching
curl -X POST "https://api.tickerbot.io/v2/signals/session_high/subscribe" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"condition": "> 465.901", "target_url": "https://example.com/hooks/tickerbot"}'

Returns 201 with the created webhook — the same shape as GET /v2/webhooks/{id}, plus a one-time signing_secret for HMAC verification.

Use scan /v2/scan

The whole market through a WHERE clause — this signal composed freely with any other column. Docs →

Live — the whole market, ranked by this column
curl -G "https://api.tickerbot.io/v2/scan" \
  --data-urlencode "q=session_high IS NOT NULL" \
  -d "order=session_high" -d "columns=session_high" \
  -H "Authorization: Bearer YOUR_KEY"
Response (sampled 2026-08-18, trimmed)
{
 "as_of": "2026-08-18T00:25:49.002Z",
 "query": {
  "q": "session_high IS NOT NULL",
  "limit": 2,
  "order": "session_high",
  "dir": "desc",
  "fields": [
   "session_high"
  ],
  "full": false,
  "universe": null,
  "asset_class": null
 },
 "count": 2,
 "results": [
  {
   "ticker": "BRK.A",
   "name": "Berkshire Hathaway Inc.",
   "asset_class": "stocks",
   "asset_type": "CS",
   "price": 747658.72,
   "day_change_pct": -0.0105,
   "gap_pct": 0,
   "relative_volume": null,
   "market_cap": 1078304184071,
   "session_high": 755732.15
  },
  {
   "ticker": "NVR",
   "name": "NVR, Inc.",
   "asset_class": "stocks",
   "asset_type": "CS",
   "price": 6241,
   "day_change_pct": -0.0106,
   "gap_pct": -0.0037,
   "relative_volume": null,
   "market_cap": 16809750339,
   "session_high": 6333.34
  }
 ]
}
As-of — the same scan at a past date
curl -G "https://api.tickerbot.io/v2/scan" \
  --data-urlencode "q=session_high IS NOT NULL" \
  -d "order=session_high" -d "columns=session_high" \
  -d "asof=2026-05-20" \
  -H "Authorization: Bearer YOUR_KEY"
Response (sampled 2026-08-18, trimmed)
{
 "as_of": "2026-05-20",
 "query": {
  "q": "session_high IS NOT NULL",
  "asof": "2026-05-20",
  "interval": "auto",
  "limit": 2,
  "order": "session_high",
  "dir": "desc",
  "fields": [
   "session_high"
  ],
  "full": false,
  "universe": null,
  "asset_class": null
 },
 "count": 2,
 "results": [
  {
   "ticker": "R:EFFR",
   "name": "Effective Federal Funds Rate",
   "asset_class": "rates",
   "asset_type": null,
   "price": 3.62,
   "day_change_pct": 0,
   "gap_pct": null,
   "relative_volume": null,
   "market_cap": null,
   "session_high": null
  },
  {
   "ticker": "R:FFLOWER",
   "name": "Fed Funds Target Range — Lower Bound",
   "asset_class": "rates",
   "asset_type": null,
   "price": 3.5,
   "day_change_pct": 0,
   "gap_pct": null,
   "relative_volume": null,
   "market_cap": null,
   "session_high": null
  }
 ]
}
Subscribe — webhook on a market-wide condition
curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"q": "session_high > 465.901", "target_url": "https://example.com/hooks/tickerbot"}'

Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.

Use series /v2/series

Its history over time, on one aligned grid. Docs →

History — the column on an aligned time grid
curl "https://api.tickerbot.io/v2/series?tickers=AAPL,MSFT&columns=close,session_high" \
  -H "Authorization: Bearer YOUR_KEY"
Response (sampled 2026-08-18, trimmed)
{
 "as_of": "2026-08-18T00:25:51.696Z",
 "interval": "1d",
 "tickers": [
  "AAPL",
  "MSFT"
 ],
 "columns": [
  "close",
  "session_high"
 ],
 "count": 6,
 "series": {
  "AAPL": [
   {
    "t": "2026-08-12",
    "close": 302.25,
    "session_high": 305.2
   },
   {
    "t": "2026-08-13",
    "close": 305.26,
    "session_high": 305.919
   },
   {
    "t": "2026-08-14",
    "close": 305.93,
    "session_high": 307.395
   }
  ],
  "MSFT": [
   {
    "t": "2026-08-12",
    "close": 492.43,
    "session_high": 502.024
   },
   {
    "t": "2026-08-13",
    "close": 496.88,
    "session_high": 501.144
   },
   {
    "t": "2026-08-14",
    "close": 495.4,
    "session_high": 499.881
   }
  ]
 }
}

Same grammar on scan, series, and webhooks; state reads take ?asof= for point-in-time answers.

Related signals — Session levels & position