API reference - Mithril

Every endpoint is documented in the Endpoints section of this tab — an interactive reference with request/response schemas and a “try it” console, generated directly from the gateway’s route table so it can’t drift. Request and response contracts (field-by-field JSON with worked examples) also live in the guides.

Open Endpoints in the sidebar to browse every operation with schemas and a live request console. Prefer the Python SDK for real integrations — it wraps these endpoints with typed models and idempotency.

Endpoint map

All endpoints are under https://api.trymithril.com/v1 and require a bearer key.

Accounts

Method	Path
`GET`	`/v1/subaccounts`
`POST`	`/v1/subaccounts`
`GET`	`/v1/subaccounts/{id}`
`DELETE`	`/v1/subaccounts/{id}`
`PUT`	`/v1/subaccounts/{id}/credentials`
`DELETE`	`/v1/subaccounts/{id}/credentials/{exchange}`
`GET`	`/v1/subaccounts/{id}/balances`

Market data

Method	Path
`GET`	`/v1/markets`
`GET`	`/v1/markets/{id}`
`GET`	`/v1/markets/{id}/orderbook`
`GET`	`/v1/markets/{id}/prices`
`POST`	`/v1/markets/match`

Orders

Method	Path
`POST`	`/v1/orders`
`GET`	`/v1/orders`
`GET`	`/v1/orders/{id}`
`POST`	`/v1/orders/{id}/cancel`
`POST`	`/v1/orders/cancel_all`

Smart execution

Method	Path
`POST`	`/v1/complex_orders`
`POST`	`/v1/complex_orders/preview`
`GET`	`/v1/complex_orders`
`GET`	`/v1/complex_orders/{id}`
`GET`	`/v1/complex_orders/{id}/children`
`GET`	`/v1/complex_orders/{id}/execution_report`
`POST`	`/v1/complex_orders/{id}/cancel`

Guardrails

Method	Path
`GET` / `PUT`	`/v1/risk_limits`
`GET` / `PUT`	`/v1/risk_limits/{subaccount_id}`

Risk, P&L & reporting

Method	Path
`GET`	`/v1/risk/stats`
`GET`	`/v1/risk/stats/{subaccount_id}`
`GET`	`/v1/risk/pnl_history`
`GET`	`/v1/positions`
`GET`	`/v1/fills`
`GET`	`/v1/portfolio`
`GET`	`/v1/receipts`
`GET`	`/v1/analytics/execution`

Trading through an AI agent instead? The same operations are exposed as tools on the hosted MCP server at https://mcp.trymithril.com/mcp.