> ## Documentation Index > Fetch the complete documentation index at: https://docs.d1.exchange/llms.txt > Use this file to discover all available pages before exploring further. # Get market > One market's terms and its settlement summary. Guide: [Markets & Market Data](/market-makers/market-data#get-one-market). ## OpenAPI ````yaml /api-reference/openapi.json get /mm/v1/markets/{instrumentId} openapi: 3.1.0 info: title: D1 Market Maker API version: mm/v1 description: >- API for authorized market makers: market data, account state, order placement and cancellation, fills and sequenced executions. Read endpoints require the mm:read scope; trading endpoints require mm:trade. servers: - url: '{D1_API_URL}' description: Base URL provided by D1 during onboarding. variables: D1_API_URL: default: $D1_API_URL description: Provided by D1 during onboarding. security: - bearerAuth: - mm:read tags: - name: Status - name: Market data - name: Account - name: Orders - name: Trading - name: Executions paths: /mm/v1/markets/{instrumentId}: get: tags: - Market data summary: Get market description: >- One market's terms and its settlement summary. Guide: [Markets & Market Data](/market-makers/market-data#get-one-market). operationId: getMarket parameters: - name: instrumentId in: path required: true schema: type: string description: Market identifier from /mm/v1/markets. responses: '200': description: OK content: application/json: schema: type: object properties: market: $ref: '#/components/schemas/Market' settlement: $ref: '#/components/schemas/Settlement' serverTimeMs: type: string description: >- D1 server time at the read, Unix milliseconds, as a decimal string. example: '1800000000000' required: - market - settlement - serverTimeMs example: market: instrumentId: underlying: BTC optionType: CALL exerciseStyle: EUROPEAN settlementType: CASH strike: units: '100000' decimals: 0 expirySeconds: '1800000000' expiryMs: '1800000000000' contractSize: units: '1' decimals: 0 priceTick: units: '1' decimals: 0 quantityStep: units: '1' decimals: 0 quoteAsset: USDC settlementAsset: USDC collateralAsset: USDC premiumUnit: QUOTE_PER_CONTRACT status: ACTIVE tradingPaused: false settlement: status: NONE settlementPrice: null settledAtMs: null serverTimeMs: '1800000000456' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/Internal' components: schemas: Market: type: object properties: instrumentId: type: string description: Unique, stable market identifier. Opaque. underlying: type: string description: Underlying asset. example: BTC optionType: type: string enum: - CALL - PUT exerciseStyle: type: string enum: - EUROPEAN - AMERICAN settlementType: type: string enum: - CASH strike: $ref: '#/components/schemas/Exact' description: Strike price in the quote asset. expirySeconds: type: string description: Expiry, Unix seconds, as a decimal string. example: '1800000000' expiryMs: type: string description: Expiry, Unix milliseconds, as a decimal string. example: '1800000000000' contractSize: $ref: '#/components/schemas/Exact' description: Units of the underlying per contract. priceTick: $ref: '#/components/schemas/Exact' description: Minimum price increment. quantityStep: $ref: '#/components/schemas/Exact' description: Minimum quantity increment, in contracts. quoteAsset: type: string example: USDC settlementAsset: type: string example: USDC collateralAsset: type: string example: USDC premiumUnit: type: string description: How prices are expressed. enum: - QUOTE_PER_CONTRACT - QUOTE_PER_UNDERLYING status: $ref: '#/components/schemas/MarketStatus' tradingPaused: type: boolean description: >- True while D1 has paused trading on this market. Independent of status. required: - instrumentId - underlying - optionType - exerciseStyle - settlementType - strike - expirySeconds - expiryMs - contractSize - priceTick - quantityStep - quoteAsset - settlementAsset - collateralAsset - premiumUnit - status - tradingPaused Settlement: type: object properties: status: type: string description: >- NONE: no settlement price accepted. LOCKED: price accepted, settlement not complete. SETTLED: complete. enum: - NONE - LOCKED - SETTLED settlementPrice: oneOf: - $ref: '#/components/schemas/Exact' - type: 'null' description: Accepted settlement price. Null when status is NONE. settledAtMs: oneOf: - type: string - type: 'null' description: >- Unix milliseconds as a decimal string. Null unless status is SETTLED. required: - status - settlementPrice - settledAtMs Exact: type: object properties: units: type: string description: >- Integer value as a decimal string. May be negative. May exceed 2^53 − 1: parse with BigInt or a decimal library, never Number. example: '105000123456' decimals: type: integer minimum: 0 description: Scale. value = units × 10^-decimals. example: 6 required: - units - decimals description: Exact fixed-point number. value = units × 10^-decimals. MarketStatus: type: string description: Market lifecycle status. enum: - ACTIVE - TRADING_CLOSED - EXPIRING - SETTLED Error: type: object properties: error: type: string description: Stable error code. enum: - AUTH_REQUIRED - INVALID_API_KEY - API_KEY_REVOKED - DEALER_SUSPENDED - INSUFFICIENT_SCOPE - MALFORMED_REQUEST - INVALID_CURSOR - NOT_FOUND - RATE_LIMITED - INTERNAL - TRADING_DISABLED - UNKNOWN_INSTRUMENT - MARKET_NOT_TRADING - MARKET_PAUSED - INVALID_PRICE - INVALID_QUANTITY - IDEMPOTENCY_CONFLICT - INSUFFICIENT_FUNDS - INSUFFICIENT_POSITION - RISK_LIMIT - ORDER_NOT_FOUND - ORDER_NOT_CANCELLABLE message: type: string description: Human-readable message. Do not parse. limit: type: string enum: - MAX_OPEN_EXPOSURE - MAX_RESTING_ORDERS - MAX_RESTING_ORDERS_PER_INSTRUMENT description: >- Present only when error is RISK_LIMIT: the limit the order would exceed. required: - error - message responses: BadRequest: description: MALFORMED_REQUEST or INVALID_CURSOR. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: MALFORMED_REQUEST message: … Unauthorized: description: AUTH_REQUIRED, INVALID_API_KEY or API_KEY_REVOKED. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: INVALID_API_KEY message: … Forbidden: description: DEALER_SUSPENDED or INSUFFICIENT_SCOPE. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: INSUFFICIENT_SCOPE message: … NotFound: description: NOT_FOUND. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: NOT_FOUND message: … RateLimited: description: >- RATE_LIMITED: not admitted. Wait Retry-After seconds, then retry the same request. headers: Retry-After: description: Seconds until the rate-limit window ends (at least 1). schema: type: integer minimum: 1 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: RATE_LIMITED message: Too many requests. Retry after the indicated delay. Internal: description: INTERNAL. Retry with backoff. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: INTERNAL message: … securitySchemes: bearerAuth: type: http scheme: bearer description: >- Authorization: Bearer . Scopes: mm:read (GET endpoints), mm:trade (POST endpoints). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.