# Mithril

## Docs

- [Introduction](https://docs.trymithril.com/index.md): Welcome to your project
- [Quickstart](https://docs.trymithril.com/quickstart.md): From an API key to a risk-checked order in a few minutes.
- [Authentication](https://docs.trymithril.com/authentication.md): How the gateway authenticates your requests.
- [Python SDK](https://docs.trymithril.com/sdks/python.md): The official Python client for Mithril — typed, batteries-included.
- [MCP server (AI agents)](https://docs.trymithril.com/sdks/mcp.md): Let Claude or any MCP agent trade through Mithril — with your risk limits enforced.
- [Conventions](https://docs.trymithril.com/concepts/conventions.md): Base URL, IDs, units, pagination — the shared rules across every endpoint.
- [Idempotency](https://docs.trymithril.com/concepts/idempotency.md): Make order placement safe to retry.
- [Errors](https://docs.trymithril.com/concepts/errors.md): The single error envelope and what each status means.
- [Rate limits](https://docs.trymithril.com/concepts/rate-limits.md): How the gateway paces requests, and how to handle 429s.
- [Accounts](https://docs.trymithril.com/guides/accounts.md): Workspaces, subaccounts, and unified balances.
- [Market data](https://docs.trymithril.com/guides/market-data.md): Search markets, read the orderbook, pull prices — normalized across venues.
- [Guardrails](https://docs.trymithril.com/guides/guardrails.md): Server-side risk limits checked before any order reaches the venue.
- [Orders](https://docs.trymithril.com/guides/orders.md): Place, track, and cancel orders through one API.
- [Smart execution](https://docs.trymithril.com/guides/smart-execution.md): Preview impact, work orders into thin books, and measure every fill.
- [Risk & P&L](https://docs.trymithril.com/guides/risk.md): Exposure, P&L, fills, and portfolio — one call each, per subaccount or workspace.
- [API reference](https://docs.trymithril.com/api-reference/overview.md): Every endpoint the gateway serves, with a live, machine-generated spec.
- [Health check](https://docs.trymithril.com/api-reference/system/health-check.md)
- [List execution analytics (predicted vs realized)](https://docs.trymithril.com/api-reference/analytics/list-execution-analytics-predicted-vs-realized.md)
- [Create API key](https://docs.trymithril.com/api-reference/api-keys/create-api-key.md)
- [Revoke API key](https://docs.trymithril.com/api-reference/api-keys/revoke-api-key.md)
- [List complex orders](https://docs.trymithril.com/api-reference/complex-orders/list-complex-orders.md)
- [Create complex order](https://docs.trymithril.com/api-reference/complex-orders/create-complex-order.md)
- [Preview order impact + recommended plan](https://docs.trymithril.com/api-reference/complex-orders/preview-order-impact-+-recommended-plan.md)
- [Get complex order](https://docs.trymithril.com/api-reference/complex-orders/get-complex-order.md)
- [Cancel complex order](https://docs.trymithril.com/api-reference/complex-orders/cancel-complex-order.md)
- [List a complex order's child orders + queue positions](https://docs.trymithril.com/api-reference/complex-orders/list-a-complex-orders-child-orders-+-queue-positions.md)
- [Get complex order execution quality (TCA)](https://docs.trymithril.com/api-reference/complex-orders/get-complex-order-execution-quality-tca.md)
- [List fills](https://docs.trymithril.com/api-reference/fills/list-fills.md)
- [Search markets](https://docs.trymithril.com/api-reference/markets/search-markets.md)
- [Match markets](https://docs.trymithril.com/api-reference/markets/match-markets.md)
- [Get market](https://docs.trymithril.com/api-reference/markets/get-market.md)
- [Get market orderbook](https://docs.trymithril.com/api-reference/markets/get-market-orderbook.md)
- [Get market prices](https://docs.trymithril.com/api-reference/markets/get-market-prices.md)
- [List orders](https://docs.trymithril.com/api-reference/orders/list-orders.md)
- [Place order](https://docs.trymithril.com/api-reference/orders/place-order.md)
- [Cancel all orders](https://docs.trymithril.com/api-reference/orders/cancel-all-orders.md)
- [Get order](https://docs.trymithril.com/api-reference/orders/get-order.md)
- [Cancel order](https://docs.trymithril.com/api-reference/orders/cancel-order.md)
- [Get portfolio](https://docs.trymithril.com/api-reference/portfolio/get-portfolio.md)
- [List positions](https://docs.trymithril.com/api-reference/positions/list-positions.md)
- [List execution receipts](https://docs.trymithril.com/api-reference/receipts/list-execution-receipts.md)
- [Get daily realized P&L history](https://docs.trymithril.com/api-reference/risk/get-daily-realized-p&l-history.md)
- [Get portfolio risk statistics](https://docs.trymithril.com/api-reference/risk/get-portfolio-risk-statistics.md)
- [Get account risk statistics](https://docs.trymithril.com/api-reference/risk/get-account-risk-statistics.md)
- [Get workspace risk limits](https://docs.trymithril.com/api-reference/risk-limits/get-workspace-risk-limits.md)
- [Update workspace risk limits](https://docs.trymithril.com/api-reference/risk-limits/update-workspace-risk-limits.md)
- [Get subaccount risk limits](https://docs.trymithril.com/api-reference/risk-limits/get-subaccount-risk-limits.md)
- [Update subaccount risk limits](https://docs.trymithril.com/api-reference/risk-limits/update-subaccount-risk-limits.md)
- [List subaccounts](https://docs.trymithril.com/api-reference/subaccounts/list-subaccounts.md)
- [Create subaccount](https://docs.trymithril.com/api-reference/subaccounts/create-subaccount.md)
- [Get subaccount](https://docs.trymithril.com/api-reference/subaccounts/get-subaccount.md)
- [Delete subaccount](https://docs.trymithril.com/api-reference/subaccounts/delete-subaccount.md)
- [Get subaccount balances](https://docs.trymithril.com/api-reference/subaccounts/get-subaccount-balances.md)
- [Set exchange credentials](https://docs.trymithril.com/api-reference/subaccounts/set-exchange-credentials.md)
- [Delete exchange credentials](https://docs.trymithril.com/api-reference/subaccounts/delete-exchange-credentials.md)
- [Create workspace](https://docs.trymithril.com/api-reference/workspaces/create-workspace.md)

## OpenAPI Specs

- [openapi](https://docs.trymithril.com/api-reference/openapi.json)

## Optional

- [Dashboard](https://app.trymithril.com)
- [Book a call](https://cal.com/karl-mithril/demo)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.