# 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.