Quickstart

This guide takes you from zero to your first David response. You’ll authenticate, find a scenario, and query prices, fundamentals, and news for a ticker inside that scenario.

Working in Python? The official SDK wraps every endpoint: pip install david-data.

Prerequisites

An API key. Get one from the dashboard, and pass it in the X-API-KEY header on every request.
The base URL for all requests is https://api.davidhf.com.

Every data endpoint requires a scenario_id. A scenario is a self-contained synthetic market world. See Scenarios for the full model.

Get started

Authenticate

Send your key in the X-API-KEY header. A quick health check confirms the connection:

curl -s https://api.davidhf.com/health \
  -H "X-API-KEY: YOUR_API_KEY"

{ "status": "ok", "environment": "production" }

Find a scenario

David ships with a library of ready-made scenarios. List them to grab a scenario_id:

curl -s "https://api.davidhf.com/scenarios?limit=3" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.scenarios.list(limit=3)

{
  "scenarios": [
    {
      "id": "6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0",
      "status": "ready",
      "name": "War-driven energy shock: shipping-lane escalation ...",
      "start_date": "1993-05-28",
      "end_date": "2023-05-08",
      "public_summary": { "scenario_theme": "geopolitical_war_energy_shock", "...": "..." }
    }
  ]
}

Copy an id. You’ll use it as scenario_id in every query below.

See what's inside

Inspect a scenario to see its date range and available tickers:

curl -s "https://api.davidhf.com/scenarios/6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.scenarios.get("6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0")

The response includes available_tickers (e.g. AAPL, MSFT, NVDA) and a public_summary describing the market world.

Pull prices

Query daily OHLCV for a ticker in that scenario:

curl -s "https://api.davidhf.com/prices?scenario_id=6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0&ticker=AAPL&interval=day&limit=5" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.prices.get("AAPL", scenario_id="6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0", interval="day", limit=5)

{
  "ticker": "AAPL",
  "prices": [
    { "ticker": "AAPL", "open": 182.4, "high": 184.1, "low": 181.2, "close": 183.6, "volume": 51200000, "time": "2026-01-02" }
  ]
}

Pull fundamentals and news

Same scenario_id, different endpoint:

# Quarterly income statements
curl -s "https://api.davidhf.com/financials/income-statements?scenario_id=6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0&ticker=AAPL&period=quarterly&limit=4" \
  -H "X-API-KEY: YOUR_API_KEY"

# Latest news visible as of a date
curl -s "https://api.davidhf.com/news?scenario_id=6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0&ticker=AAPL&as_of=2026-03-20" \
  -H "X-API-KEY: YOUR_API_KEY"

# Quarterly income statements
dd.financials.income_statements("AAPL", scenario_id="6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0", period="quarterly", limit=4)

# Latest news visible as of a date
dd.news.list(ticker="AAPL", scenario_id="6724c7d1-1b34-5da4-bc69-5ab0ef99c3c0", as_of="2026-03-20")

Browse more scenarios

David curates the full scenario library, you don’t generate worlds, you choose from them. Filter the library to assemble the sets you need:

# Future-branch scenarios that passed validation
curl -s "https://api.davidhf.com/scenarios?path_mode=future_branch&healthy_only=true&limit=10" \
  -H "X-API-KEY: YOUR_API_KEY"

# Future-branch scenarios that passed validation
dd.scenarios.list(path_mode="future_branch", healthy_only=True, limit=10)

Need a world with characteristics the library doesn’t cover? Reach out at founders@davidhf.com and we’ll generate it.

Next steps

Scenarios

How worlds are scoped, validated, and replayed.

Authentication

Keys, accounts, plans, and rate limits.

Point-in-time agents

Build a leakage-free backtest loop.

API reference

Every endpoint in detail.

Need help? Reach out at founders@davidhf.com.

Get started

Core concepts

Clients

Guides

Prerequisites

Get started

Browse more scenarios

Next steps

Scenarios

Authentication

Point-in-time agents

API reference

​Prerequisites

​Get started

​Browse more scenarios

​Next steps

Scenarios

Authentication

Point-in-time agents

API reference

Prerequisites

Get started

Browse more scenarios

Next steps