Data API

ctx.data is a DataAccessor. All accessors accept symbols, lookback, start_date, and end_date. Panel methods return a DataFrame indexed by date with one column per symbol.

returns

Daily simple returns panel (dates x symbols). Uses adjusted_close when available, else close. NaNs are dropped.

python
returns(symbols=None, lookback=None, start_date=None, end_date=None) -> pd.DataFrame

Returns

pd.DataFrame

Example

python
1
2
r = ctx.data.returns(lookback=126)   # 126 trading days
momentum = (1 + r).prod() - 1

ohlcv

Raw OHLCV rows as a MultiIndex (date, symbol) DataFrame with open/high/low/close/volume (and adjusted_close / vwap when available).

python
ohlcv(symbols=None, lookback=None, end_date=None, start_date=None) -> pd.DataFrame

Returns

pd.DataFrame (MultiIndex: date, symbol)

Example

python
1
bars = ctx.data.ohlcv(symbols=["AAPL", "MSFT"], lookback=30)

close / open / high / low / volume / vwap

Per-field panels (dates x symbols). close() uses adjusted_close when present. vwap() falls back to (H+L+C)/3 if no vwap column exists.

python
close(symbols=None, lookback=None, ...) -> pd.DataFrame

Returns

pd.DataFrame (dates x symbols)

Example

python
1
2
3
close = ctx.data.close(lookback=50)
vol = ctx.data.volume(lookback=20)
sma_50 = close.rolling(50).mean().iloc[-1]

fundamentals

Return a fundamentals dataset for one symbol, or None if unavailable. Datasets include key_metrics_ttm and ratios_ttm (FMP-sourced).

python
fundamentals(symbol: str, dataset: str = "key_metrics_ttm") -> dict | None

Parameters

NameTypeRequiredDescription
symbolstrTicker symbol
datasetstre.g. "key_metrics_ttm", "ratios_ttm"

Returns

dict | None

Example

python
1
2
km = ctx.data.fundamentals("AAPL", "key_metrics_ttm")
pe = (km or {}).get("peRatioTTM")

sector / market_cap

Reference lookups from the security master.

python
sector(symbol: str) -> str | None   |   market_cap(symbol: str) -> float | None

Returns

str | float | None

Example

python
1
tech = [s for s in universe if ctx.data.sector(s) == "Technology"]

For the full field catalog (60+ key-metrics TTM fields, 70+ ratios TTM fields), see the Data Reference and Data Sources.