Skip to main content
Metadata endpoints describe the platform itself: what’s covered, how it scales, which themes exist, and how the synthetic data is calibrated and audited. These endpoints are scenario-independent unless noted.

​
Financial Datasets coverage

GET /metadata/financial-datasets-coverage
The live map of David’s endpoint surface against the Financial Datasets API surface, including which operations are native vs. derived compatibility views. 
curl -s "https://api.davidhf.com/metadata/financial-datasets-coverage" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "financial_datasets_coverage": {
    "implemented_operation_count": 49,
    "coverage_ratio": 1.0,
    "operations": ["..."],
    "important_note": "The paths are compatible synthetic equivalents and include derived views ..."
  }
}

​
Scenario themes

GET /metadata/scenario-themes
The full theme catalog: id, title, description, macro regime, event template, sectors, market mechanics, and the agent task each theme poses. 
curl -s "https://api.davidhf.com/metadata/scenario-themes" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "scenario_themes": [
    {
      "id": "geopolitical_war_energy_shock",
      "title": "War-driven energy shock",
      "description": "A regional war disrupts energy supply ...",
      "macro_regime": "inflation_shock",
      "event_template": "...",
      "sectors": ["Energy", "Industrials", "..."],
      "market_mechanics": ["energy and materials gain on commodity pricing power", "..."],
      "agent_task": "Separate durable commodity winners from temporary spikes."
    }
  ]
}

​
Institutional readiness

GET /metadata/institutional-readiness
A readiness report describing the calibration and quality gates the data is evaluated against. 
curl -s "https://api.davidhf.com/metadata/institutional-readiness" \
  -H "X-API-KEY: YOUR_API_KEY"

​
Empirical calibration

GET /metadata/empirical-calibration
The calibration manifest: stylized-fact gates (volatility, kurtosis, clustering, drawdown, tails, coverage) and current margins against measured market panels.
ParameterTypeRequiredDescription
panel_pathstringNoOptional path to a calibration panel to evaluate against.
curl -s "https://api.davidhf.com/metadata/empirical-calibration" \
  -H "X-API-KEY: YOUR_API_KEY"

​
Synthetic-data audit

GET /metadata/synthetic-data-audit
A library-wide self-audit: scenario uniqueness, intentional repeated-theme variants, path-mode and horizon diversity, and calibration-gate margins across the library. 
curl -s "https://api.davidhf.com/metadata/synthetic-data-audit" \
  -H "X-API-KEY: YOUR_API_KEY"
Per-scenario consistency lives on the Scenarios endpoints via /validation. The endpoints here audit the platform and library as a whole.