# Market Atlas

**The live map of global markets** — https://www.market-atlas.co

Market Atlas observes thousands of market-related sources (exchange feeds, official statistics, regulators, public quote pages,
directories), normalizes every observation with its provenance and data rights, resolves it to a canonical instrument, compares
independent sources into a consensus value, detects what changed, remembers everything, and redistributes the result through one
web application, a REST API and a WebSocket/SSE stream.

```
pnpm install
cp .env.example .env            # Postgres URL, admin token, contact e-mail, optional HFMD_API_KEY
pnpm migrate && pnpm seed       # schema + reference data (countries, exchanges, holidays)
pnpm dev:api                    # Fastify + workers + connectors on :8391  (roles: MA_ROLE=all|api|worker)
pnpm dev:web                    # Next.js on :8390 (rewrites /v1 → API)
pnpm test · pnpm typecheck      # vitest (model, SDK, connectors, consensus, calendar) · tsc
pnpm ma connectors | run <id> | replay <day> | status | archive | backup
```

Repository map: `packages/market-model` (canonical vocabulary & types) · `packages/connector-sdk` · `connectors/` (14 production
connectors with fixtures and READMEs) · `apps/api` (engines, API, stream, admin, CLI) · `apps/web` (Next.js) · `infra/migrations` ·
`docs/` (ARCHITECTURE, CONNECTORS, API, FRONTEND, DEPLOY) · `deploy/` (mld manifest) · `CLAUDE.md` (product & engineering charter).

Market Atlas is an informational market-data and analytics platform. Information may be delayed, indicative, incomplete, or sourced
from third parties. Market Atlas is not an exchange, broker, investment adviser, or execution venue.