# Simetrix Full Reference (Condensed)

```bash
# Simetrix CLI (Python SDK)
# Install: pip install simetrix-sdk
# Forecast a symbol
simetrix forecast --symbol X:NVDA --horizon-days 45
# Fetch targets ladder
simetrix targets --symbol X:NVDA
# List recent runs
simetrix runs --limit 5
# Check quota usage
simetrix quota
```

## Simetrix API (Forecasting + Simulation)
- Base URL: https://api.simetrix.io
- Docs: https://api.simetrix.io/api-docs
- Core routes: /simulate/*, /v2/forecast/*, /analytics/*, /copilot/tools/*, /metrics
- Public attestations: /public/attestations

## Market Twin (Inference Engine)
- Interfaces: /v1/infer/*
- Registry artifacts: data/registry/market_twin/*
- Uses scenario_hash for conditioned inference

## Scenario Engine (Deterministic Scenarios)
- Interfaces: /scenario/run, /scenario/batch/run, /scenario/summary/*, /scenario/health
- Quotas: Redis-backed per-tenant budgets

## MarketSimulator (Replay + Narrative Lab)
- Dashboard: /dashboard
- Feeds: SSE/WS
- Artifacts: runs/ (RunManifest)

## Simetrix AI Trader (Execution)
- Public API base: https://api.simetrix.trade
- Routes: /v1/*, /metrics, WS feeds
- Dashboards: /settings, /ops, /risk

## Simetrix Frontend (App)
- Routes: /app, /portfolio, /scenario-studio, /market-simulator, /docs, /ops
- Vite app backed by Simetrix API + Market Twin outputs

## Auth and Scopes (Common)
- Bearer token in Authorization header
- X-API-Key or x-pt-key for some routes
- Scopes: forecast:read:v2, portfolio:read, scenario:run, scenario:condition, admin

## Local Defaults
- API: http://127.0.0.1:8900
- Other services: see each repo .env for port and host configuration

## Related Context Files
- Overview: https://simetrix.io/docs/contexts/overview.md
- API ref: https://simetrix.io/docs/contexts/api-ref.md
- Guides: https://simetrix.io/docs/contexts/guides.md