API Reference

This section lists the exact parameters and response schema for every public endpoint. To learn how to integrate, start with the Market Makers guides.

The Market Maker API is a dedicated machine-to-machine trading interface for authorized market makers. Only the endpoints listed here are part of its contract.

Base URL

D1 provides the base URL during onboarding. The examples use an environment variable:

export D1_API_URL="<provided-by-d1>"

All paths are relative to it, for example $D1_API_URL/mm/v1/status. Keep the base URL in configuration rather than hard-coding it.

Authentication

Send your API key as a Bearer token on every request. GET endpoints require the mm:read scope. POST endpoints require mm:trade, and placing a new order also requires trading to be available for your account.

curl "$D1_API_URL/mm/v1/status" \
  -H "Authorization: Bearer $D1_MM_API_KEY"

See Authentication.

Endpoints

Method	Path	Description
`GET`	`/mm/v1/status`	Key identity and permissions
`GET`	`/mm/v1/markets`	List markets
`GET`	`/mm/v1/markets/{instrumentId}`	One market and its settlement
`GET`	`/mm/v1/markets/{instrumentId}/orderbook`	Aggregated order book
`GET`	`/mm/v1/balances`	USDC balance
`GET`	`/mm/v1/positions`	Positions
`GET`	`/mm/v1/orders`	Orders and their lifecycle
`GET`	`/mm/v1/orders/{orderId}`	One order
`POST`	`/mm/v1/orders`	Place a limit order
`POST`	`/mm/v1/orders/{orderId}/cancel`	Cancel one order
`POST`	`/mm/v1/orders/cancel-all`	Cancel all resting orders
`GET`	`/mm/v1/executions`	Sequenced execution feed
`GET`	`/mm/v1/fills`	Fill history

Shared conventions

Topic	Where it is described
Exact numbers (`{ units, decimals }`)	Exact numbers
Cursor pagination	Pagination
Idempotent placement (`clientOrderId`)	Orders
Sell-to-close and order limits	Trading Rules
Execution checkpoints	Fills & Executions
Error envelope and codes	Errors
Request budgets	Rate Limits