/v2/symbols/{symbol}/spot Latest price for one symbol
market_getSpot
The latest ITMatrixHQ price for one registry symbol, from its most recent daily bar. Use GET /v2/quotes to read many symbols at once.
Path parameters
symbolstring requiredSymbol, e.g.
SPY
Units
price is dollars; ts is the epoch-millisecond start of the bar the price came from.
Freshness
The current session's bar as it builds, otherwise the last completed session.
Limits
No per-operation limit applies to requests with an API key.
Empty results
price and ts are null when no recent bar exists. A symbol outside the registry (GET /v2/symbols) is 404 not_found.
Example
GET /v2/symbols/AAPL/spot{
"data": { "symbol": "AAPL", "price": 341.07, "ts": 1790294400000 }
}Response
Prices are dollars, timestamps epoch milliseconds, strikes integer thousandths of a dollar; null means unknown. Units →
200application/json
{symbol, price, ts} in data (price/ts null when no recent bar)
object
A successful response: the payload consumers parse plus response metadata. data shapes are the platform types — never reshaped by the envelope.
data object required
{symbol, price, ts} — the spot read. price/ts are null when no recent bar is available.
price number · double nullable USD Latest ITMatrixHQ price, dollars, or null when no recent bar exists.
symbol string required ts integer · int64 nullable epoch ms Epoch-ms of the bar the price came from.
meta object required
Response metadata.
caps object nullable
meta.caps — the entitlement caps that shaped this response. applied lists the caps that actually changed it (for example range_clamped).
applied array<string> required Which caps actually shaped this response (e.g. range_clamped). Empty = nothing was clamped.
darkpool boolean nullable Whether this account can use Off-Exchange in the site.
flow boolean nullable Whether the OPRA option-flow capability (flow) is granted to this principal in the app: site Pro plus a CBOE non-professional attestation (never on an itm_ key). Emitted explicitly — true and false — by the account endpoints, so the app reads the grant instead of inferring it from tier and attestation; absent on routes that do not report it.
gexDepth string nullable GEX data depth when the route reports it. Camel-cased to match the browser capability bundle; absent on unrelated routes.
tier string required The tier the request was served under.
cursor string nullable Opaque continuation cursor (pass back as ?cursor=); absent when there is nothing more to read.
plane string nullable Which serving tier answered the read (meta.plane). Informational provenance: treat it as an opaque label, because new values may appear.
Errors
Every error is the JSON error envelope; branch on error.code.
| Status | Meaning |
|---|---|
| 401 |
|
| 404 |
|
| 503 |
|