# Market Oracle

> Crypto market data API for trading bots, signal engines, and AI agents: closed bars with verified indicators, order-book microstructure, derivatives, macro, and market regime. Facts only — Oracle does not open trades.

Site: https://market-oracle.pro
REST base: https://api.market-oracle.pro
WebSocket: wss://api.market-oracle.pro/v1/stream

Auth: `Authorization: Bearer mo_...` on every `/v1/*` request and on the WebSocket (`?token=` only if the client cannot set WS headers). `GET /health` is public.

## Core rules

- Trade only on a closed bar (`closed: true`). Deduplicate with `${symbol}:${bar.ts}`.
- Live WS trigger is closed **1m** (`bar_close`). For 5m/15m/30m/1h use native `GET /v1/history?interval=` (do not stitch minutes for oracle-only fields). Live HTF snapshot: `context.htf` (15m/1h/4h/1d only).
- Indicators are decimal strings; warmup is `null`, never substitute `0`.
- Before entry: `GET /v1/context/{symbol}`. Enter only if `cost_risk.tradable` and `data_quality.score >= 70`.
- Symbols (fixed): BTCUSDT, ETHUSDT, SOLUSDT, BNBUSDT, DOGEUSDT, XRPUSDT. Check `ready` via `GET /v1/symbols`.

## Key endpoints

- `GET https://api.market-oracle.pro/v1/context/{symbol}` — decision snapshot (bar + indicators + book + cost + HTF + derivatives + macro + quotes + regime + quality)
- `GET https://api.market-oracle.pro/v1/history/{symbol}?interval=` — native candles with indicators (`1m` `5m` `15m` `30m` `1h` `4h` `1d` `1w`)
- `GET https://api.market-oracle.pro/v1/microstructure/{symbol}` — closed-minute top-20 facts (spread, imbalance, walls, pressure)
- `GET https://api.market-oracle.pro/v1/derivatives/{symbol}` — funding, open interest, liquidations
- `GET https://api.market-oracle.pro/v1/macro` — Fear&Greed, dominance, DXY, yields
- `GET https://api.market-oracle.pro/v1/market-regime` — BTC correlation, realized vol, breadth
- `GET https://api.market-oracle.pro/v1/quotes/{symbol}` — multi-source mid consensus
- `GET https://api.market-oracle.pro/v1/calendar` — macro events (FOMC, CPI)
- `GET https://api.market-oracle.pro/v1/symbols` — readiness
- `GET https://api.market-oracle.pro/v1/me` — plan limits (does not spend daily quota)
- `GET https://api.market-oracle.pro/health` — liveness
- `WS wss://api.market-oracle.pro/v1/stream` — `bar_close`; opt-in `microstructure:true` for `microstructure_close` (not a raw L2 stream; no 5m/15m closes)

No official SDK. Use HTTP + JSON. Human docs include Python stdlib and Node.js fetch samples.

## Documentation

- [English hub](https://market-oracle.pro/en): marketing overview, FAQ, code sample
- [Russian hub](https://market-oracle.pro/ru): same in Russian
- [English API docs](https://market-oracle.pro/en/docs): human HTML reference
- [Russian API docs](https://market-oracle.pro/ru/docs): human HTML reference
- [English agent spec (Markdown)](https://market-oracle.pro/en/docs/agents.md): canonical machine contract — feed this to an AI coding agent
- [Russian agent spec (Markdown)](https://market-oracle.pro/ru/docs/agents.md): same contract in Russian
- [Full spec dump](https://market-oracle.pro/llms-full.txt): `agents.en.md` as `text/markdown` (`Accept: text/markdown` also works on the agents.md URLs)

## Optional

- [License / public offer](https://market-oracle.pro/ru/docs/license.md)
- [Privacy](https://market-oracle.pro/ru/docs/privacy.md)