Company

Company facts describe the identity of each issuer in a scenario: name, sector, industry, exchange, CIK, and listing metadata. Identity is grounded in real reference data; everything financial is synthetic. See Ticker universe.

Company facts

GET /company/facts

Returns facts for a single company by ticker or cik.

Parameter	Type	Required	Description
`scenario_id`	string	Yes	The world to read from.
`ticker`	string	No	Symbol to look up.
`cik`	string	No	CIK to look up (alternative to `ticker`).

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>")

{
  "company_facts": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "category": "Operating Company",
    "exchange": "NASDAQ",
    "is_active": true,
    "location": "Cupertino, CA",
    "sic_code": "3571",
    "sic_industry": "Electronic Computers",
    "sic_sector": "Manufacturing",
    "sec_filings_url": "https://.../cik=0000320193"
  }
}

Returns 404 if the company is not found in the scenario.

List companies

GET /companies

List or search companies in a scenario.

Parameter	Type	Required	Default	Description
`scenario_id`	string	Yes	-	The world to read from.
`ticker`	string	No	-	Filter to a single ticker.
`search`	string	No	-	Free-text search over name, sector, industry, or ticker (≤128 chars).
`limit`	integer	No	100	Page size (max 5000).
`offset`	integer	No	0	Pagination offset.

curl -s "https://api.davidhf.com/companies?scenario_id=<id>&search=semiconductor&limit=25" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.company.list(scenario_id="<id>", search="semiconductor", limit=25)

{ "companies": [ { "ticker": "NVDA", "name": "NVIDIA Corp.", "sector": "Technology", "...": "..." } ] }

Discovery helpers

List the identifiers actually present in a scenario.

GET /company/facts/tickers

{ "tickers": ["AAPL", "MSFT", "NVDA", "..."] }

GET /company/facts/ciks

{ "ciks": ["0000320193", "0000789019", "..."] }

Both take only scenario_id.

curl -s "https://api.davidhf.com/company/facts/tickers?scenario_id=<id>" \
  -H "X-API-KEY: YOUR_API_KEY"

dd.company.tickers(scenario_id="<id>")

Overview

Scenarios

Prices

Financials

Earnings & estimates

Disclosures

Ownership

Market & macro

Company

Company facts

List companies

Discovery helpers

​Company facts

​List companies

​Discovery helpers

Company facts

List companies

Discovery helpers