# MagicMarkets API

> REST and WebSocket API for MagicMarkets: place orders, stream real-time
> prices, and manage positions programmatically. Every request is
> authenticated with an `X-Api-Key` header; keys are created on the
> MagicMarkets website. The REST API lives under `/v2/`, the price stream
> at `/v2/stream` (WebSocket).

Links below are relative to the URL this file was fetched from.

## Docs

- [Full API reference (Markdown)](llms-full.txt): all endpoints, schemas, and guides (authentication, quickstart, errors, currencies, sports & bet types, idempotency) in a single Markdown file
- [Interactive API reference (HTML)](docs): Redoc rendering of the same spec; request it with `Accept: text/markdown` to get the Markdown version instead

## Machine-readable spec

- [OpenAPI 3.1 spec (YAML)](v2/openapi.yaml): canonical hand-curated OpenAPI document
- [OpenAPI 3.1 spec (JSON)](v2/openapi.json): the same spec as JSON