REST API
Endpoint Reference
Every REST API endpoint, grouped by the capability tier it requires.
The definitive, always-current reference is the interactive spec at /api/v1/docs (OpenAPI 3.1, served from /api/v1/openapi.json). This page mirrors it in table form for quick scanning and linking.
All paths are relative to https://api.mtcontext.com. See Getting Started for authentication, rate limits, and response format.
Free+ (no capability required)
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/market/tick/:symbol | Current tick data |
| GET | /api/v1/market/bars/:symbol | OHLCV bars |
| GET | /api/v1/market/symbols | All available symbols |
| GET | /api/v1/market/symbols/:symbol | Single symbol info |
| GET | /api/v1/market/snapshot/:symbol | Enriched tick snapshot |
| GET | /api/v1/account/info | Account balance/equity |
| GET | /api/v1/account/positions | Open positions |
| GET | /api/v1/account/orders | Pending orders |
| GET | /api/v1/account/history | Trade history |
| GET | /api/v1/indicators | List available indicators |
| GET | /api/v1/indicators/:symbol/:indicator | Technical indicator data |
| GET | /api/v1/terminal/info | Terminal info |
| GET | /api/v1/terminal/experts | Installed EAs |
| GET | /api/v1/terminal/logs | EA logs |
| GET | /api/v1/terminal/journal | Terminal journal |
| GET | /api/v1/terminals | Connected terminals |
| GET | /api/v1/analysis/key-levels/:symbol | Pivot points |
| POST | /api/v1/coaching/fibonacci | Fibonacci levels |
| GET | /api/v1/macro/sessions | Market sessions |
| POST | /api/v1/risk/lot-size | Position sizing |
| POST | /api/v1/journal | Write trade note |
| GET | /api/v1/journal | Query trade journal |
Pro+ — analytics capability
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/market/depth/:symbol | Market depth |
| POST | /api/v1/market/scan | Symbol scan |
| GET | /api/v1/analysis/patterns/:symbol | Candlestick patterns |
| GET | /api/v1/coaching/explain/:ticket | Trade explanation |
| GET | /api/v1/analytics/stats | Trading statistics |
| GET | /api/v1/analytics/pnl/symbols | P&L by symbol |
| GET | /api/v1/analytics/pnl/time | P&L by time |
| GET | /api/v1/analytics/tick-history/:symbol | Spread/tick history |
| GET | /api/v1/analytics/execution-quality | Slippage data |
| GET | /api/v1/risk/summary | Portfolio risk overview |
| GET | /api/v1/risk/correlation | Pearson correlation between two symbols |
| GET | /api/v1/macro/rates | Interest rates |
| GET | /api/v1/macro/calendar | Economic calendar |
| GET | /api/v1/macro/news | News |
| GET | /api/v1/macro/sentiment/:symbol | Sentiment |
| GET | /api/v1/macro/holding-risk/:symbol | Holding risk |
| GET | /api/v1/macro/risk-regime | Risk-on/risk-off score |
| POST/GET/DELETE | /api/v1/alerts | Alert management |
| GET | /api/v1/alerts/events | Fired alert events |
| PUT/GET/DELETE | /api/v1/news-guard | News guard configuration |
Pro+ — trade capability
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/orders | Place order (dry_run defaults to true) |
| POST | /api/v1/orders/check | Preflight order validation |
| DELETE | /api/v1/orders/:ticket | Cancel pending order |
| PATCH | /api/v1/orders/:ticket | Modify pending order |
| DELETE | /api/v1/positions/:ticket | Close position |
| PATCH | /api/v1/positions/:ticket | Modify position stop_loss/take_profit |
| POST | /api/v1/positions/:ticket/partial-close | Partial close |
| DELETE | /api/v1/positions?symbol= | Close all positions |
| POST | /api/v1/positions/:ticket/breakeven | Move SL to entry |
| POST | /api/v1/positions/:ticket/trailing-stop | Set trailing stop |
| POST | /api/v1/positions/:ticket/reverse | Reverse position |
| PUT/GET/DELETE | /api/v1/equity-guard | Equity guard configuration |
| PUT/GET/DELETE | /api/v1/prop-firm | Prop firm ruleset |
Every endpoint in this table can affect a live trading account. dry_run defaults to true on order/position endpoints — pass "dry_run": false explicitly to execute for real.
Enterprise+
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/coaching/backtest | Backtest simulation |
Not sure which tier you're on?
Check Dashboard → Billing for your current plan, or call any Free+ endpoint (like /api/v1/terminals) — a 403 FORBIDDEN on a higher-tier endpoint tells you which capability is missing.