Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Daily OHLCV bars, point-in-time snapshots, and market-wide snapshots.
GET /prices
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scenario_id | string | Yes | - | The world to read from. |
ticker | string | Yes | - | Ticker symbol to query. |
interval | string | No | day | Only day is supported; other values return 400. |
start_date | date | No | - | Inclusive window start. |
end_date | date | No | - | Inclusive window end. |
include_components | boolean | No | false | Include return-decomposition fields (see below). |
limit | integer | No | 5000 | Max bars (max 10000). |
offset | integer | No | 0 | Pagination offset. |
curl -s "https://api.davidhf.com/prices?scenario_id=<id>&ticker=AAPL&interval=day&start_date=2026-01-02&end_date=2026-03-27" \
-H "X-API-KEY: YOUR_API_KEY"
dd.prices.get("AAPL", scenario_id="<id>", interval="day", start_date="2026-01-02", end_date="2026-03-27")
{
"ticker": "AAPL",
"prices": [
{ "ticker": "AAPL", "open": 182.4, "high": 184.1, "low": 181.2, "close": 183.6, "volume": 51200000, "time": "2026-01-02" }
]
}
include_components=true, each bar adds the decomposition David used to generate it:
| Field | Description |
|---|---|
adjusted_close | Split/dividend-adjusted close. |
market_return | Market-factor component of the day’s return. |
sector_return | Sector-factor component. |
idiosyncratic_return | Stock-specific component. |
event_return | Component attributable to a scenario event. |
volatility | Modeled volatility for the bar. |
metadata | Additional bar metadata. |
GET /prices/snapshot
| Parameter | Type | Required | Description |
|---|---|---|---|
scenario_id | string | Yes | The world to read from. |
ticker | string | Yes | Ticker symbol to query. |
as_of | date | Yes | Cutoff date. |
curl -s "https://api.davidhf.com/prices/snapshot?scenario_id=<id>&ticker=AAPL&as_of=2026-03-26" \
-H "X-API-KEY: YOUR_API_KEY"
dd.prices.snapshot("AAPL", scenario_id="<id>", as_of="2026-03-26")
{ "snapshot": { "ticker": "AAPL", "close": 191.2, "time": "2026-03-26", "...": "..." } }
404 if no bar exists on or before as_of.
GET /prices/snapshot/market
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scenario_id | string | Yes | - | The world to read from. |
as_of | date | No | latest | Cutoff date. |
limit | integer | No | 500 | Tickers (max 5000). |
offset | integer | No | 0 | Pagination offset. |
curl -s "https://api.davidhf.com/prices/snapshot/market?scenario_id=<id>&as_of=2026-03-26" \
-H "X-API-KEY: YOUR_API_KEY"
dd.prices.market_snapshot(scenario_id="<id>", as_of="2026-03-26")
GET /prices/tickers
GET /prices/snapshot/tickers
scenario_id and return the tickers with price data.
{ "tickers": ["AAPL", "MSFT", "NVDA", "..."] }