# D1

> Developer documentation for integrating with D1.

- [Introduction](https://docs.d1.exchange/index.md): Integrating with D1.
- [API Reference](https://docs.d1.exchange/api-reference/introduction.md): Request and response reference for the D1 Market Maker API (/mm/v1).
- [Get status](https://docs.d1.exchange/api-reference/status/get-status.md): Identity and permissions of the API key used, whether a new order would be accepted now, and your order limits. Takes no parameters. Unlike other endpoints, the response has no serverTimeMs.
- [List markets](https://docs.d1.exchange/api-reference/market-data/list-markets.md): Market catalog. Without status: sorted by instrumentId (use for a complete sync). With status: sorted by expiry, then instrumentId; a market changing status mid-pass can be missed.
- [Get market](https://docs.d1.exchange/api-reference/market-data/get-market.md): One market's terms and its settlement summary.
- [Get order book](https://docs.d1.exchange/api-reference/market-data/get-order-book.md): Aggregated price levels, best first on both sides, with your share of each level.
- [Get balances](https://docs.d1.exchange/api-reference/account/get-balances.md): Your USDC balance. Always exactly one entry. Takes no parameters.
- [List positions](https://docs.d1.exchange/api-reference/account/list-positions.md): Your positions, sorted by instrumentId.
- [List orders](https://docs.d1.exchange/api-reference/orders/list-orders.md): Your orders, newest first, with their lifecycle.
- [Get order](https://docs.d1.exchange/api-reference/orders/get-order.md): One of your orders. An unknown order and another account's order both return 404.
- [Place order](https://docs.d1.exchange/api-reference/trading/place-order.md): Place a good-till-cancelled limit order. Requires mm:trade and trading to be available for your account. The full quantity is accepted or the order is refused; D1 never resizes an order. A refused order creates nothing. Fills from the placement are on /executions when the response arrives.
- [Cancel order](https://docs.d1.exchange/api-reference/trading/cancel-order.md): Cancel the remaining quantity of one of your orders. The body is empty or {}. Allowed while trading is disabled or your account is suspended. Safe to retry: an already-cancelled order returns result ALREADY_CANCELLED.
- [Cancel all orders](https://docs.d1.exchange/api-reference/trading/cancel-all-orders.md): Cancel all of your resting orders, or only those in one market. The body is empty, {} or {"instrumentId": "…"}. Cancels only orders that existed when it ran. If more is true, call again. Allowed while trading is disabled or your account is suspended.
- [List executions](https://docs.d1.exchange/api-reference/executions/list-executions.md): Forward execution synchronization. Returns executions with executionSequence greater than after, strictly ascending, with no gaps or repeats. Persist nextAfter only after processing the page; it equals after when the page is empty. hasMore true: request again now. Fills from before sequencing began…
- [List fills](https://docs.d1.exchange/api-reference/executions/list-fills.md): Fill history, newest first by creation time. A fill can appear behind one already paged past: use /executions for synchronization.
- [Market Makers](https://docs.d1.exchange/market-makers/introduction.md): APIs and integration guides for teams providing liquidity on D1.
- [Quickstart](https://docs.d1.exchange/market-makers/quickstart.md): From API key to a placed, reconciled and cancelled order.
- [Authentication](https://docs.d1.exchange/market-makers/authentication.md): API keys, scopes, status, rotation, revocation and key security.
- [Markets & Market Data](https://docs.d1.exchange/market-makers/market-data.md): Market catalog, market terms, order books and the exact-number format.
- [Orders](https://docs.d1.exchange/market-makers/orders.md): Place, cancel and cancel-all, safe retries with clientOrderId, and reading orders.
- [Trading Rules](https://docs.d1.exchange/market-makers/trading-rules.md): When you can place orders, sell-to-close, funds and order limits.
- [Fills & Executions](https://docs.d1.exchange/market-makers/executions.md): Sequenced execution sync with /executions, and fill history with /fills.
- [Positions & Balances](https://docs.d1.exchange/market-makers/positions-and-balances.md): Your USDC balance and option positions, and how fills change them.
- [Building a Reliable MM Client](https://docs.d1.exchange/market-makers/reliability.md): Practical rules for market-making bots: retries, timeouts, restarts and reconciliation.
- [Errors](https://docs.d1.exchange/market-makers/errors.md): Error format, error codes by category, and how to handle them.
- [Rate Limits](https://docs.d1.exchange/market-makers/rate-limits.md): Current request budgets for reads and trading, and how to handle 429 responses.
- [Changelog](https://docs.d1.exchange/changelog.md): Changes to D1's public APIs.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


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