Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Pull statements, metrics, and earnings for a company in a scenario.
id, then check which tickers it contains:
curl -s "https://api.davidhf.com/scenarios?limit=1" -H "X-API-KEY: YOUR_API_KEY"
curl -s "https://api.davidhf.com/company/facts/tickers?scenario_id=<id>" -H "X-API-KEY: YOUR_API_KEY"
dd.scenarios.list(limit=1)
dd.company.tickers(scenario_id="<id>")
curl -s "https://api.davidhf.com/company/facts?scenario_id=<id>&ticker=AAPL" \
-H "X-API-KEY: YOUR_API_KEY"
dd.company.facts("AAPL", scenario_id="<id>")
category is Operating Company, non-operating instruments (ETFs, warrants) won’t have statements.
# Income statement, last 8 quarters
curl -s "https://api.davidhf.com/financials/income-statements?scenario_id=<id>&ticker=AAPL&period=quarterly&limit=8" \
-H "X-API-KEY: YOUR_API_KEY"
# All three statements together
curl -s "https://api.davidhf.com/financials?scenario_id=<id>&ticker=AAPL&period=quarterly&limit=4" \
-H "X-API-KEY: YOUR_API_KEY"
dd.financials.income_statements("AAPL", scenario_id="<id>", period="quarterly", limit=8)
dd.financials.all_statements("AAPL", scenario_id="<id>", period="quarterly", limit=4)
period=annual or period=ttm for other views, and report_period_gte / report_period_lte to bound the fiscal range.
# Valuation, margin, and return ratios
curl -s "https://api.davidhf.com/financial-metrics?scenario_id=<id>&ticker=AAPL&period=ttm&limit=4" \
-H "X-API-KEY: YOUR_API_KEY"
# Earnings results with consensus, actuals, and surprises
curl -s "https://api.davidhf.com/earnings?scenario_id=<id>&ticker=AAPL" \
-H "X-API-KEY: YOUR_API_KEY"
dd.financials.metrics("AAPL", scenario_id="<id>", period="ttm", limit=4)
dd.earnings.list("AAPL", scenario_id="<id>")
curl -s -X POST "https://api.davidhf.com/financials/search/screener" \
-H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"scenario_id":"<id>","period":"ttm","filters":{"gross_margin":{"gte":0.4}}}'
dd.financials.screener({"gross_margin": {"gte": 0.4}}, scenario_id="<id>")