> ## Documentation Index
> Fetch the complete documentation index at: https://perps-api.vooi.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get current user settings for a market

> Read all configurable settings for one `(exchange, asset)` pair; individual settings have no dedicated read endpoint.



## OpenAPI

````yaml https://vooi-api-app.fly.dev/swagger/json get /exchange/market-settings
openapi: 3.1.0
info:
  title: VOOI API
  description: Unified perps API
  version: '1.0'
  contact: {}
servers:
  - url: https://perps-api.vooi.io
security: []
tags: []
paths:
  /exchange/market-settings:
    get:
      tags:
        - Exchange
      summary: Get current user settings for a market
      description: >-
        Read all configurable settings for one `(exchange, asset)` pair;
        individual settings have no dedicated read endpoint.
      operationId: ExchangeController_getMarketSettings
      parameters:
        - name: asset
          required: true
          in: query
          schema:
            type: string
            minLength: 1
            example: ETH
          description: >-
            Asset identifier: base symbol (e.g. "ETH") or full pair (e.g.
            "ETHUSDC").
        - name: exchange
          required: true
          in: query
          schema:
            type: string
            enum:
              - aster
              - binance
              - bybit
              - extended
              - gate
              - hyperliquid
              - lighter
              - mexc
              - ondo
              - robinhood
          description: Supported perpetual exchange
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMarketSettingsDto'
        '503':
          description: ExchangeApiError
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDTO'
      security:
        - bearer: []
components:
  schemas:
    GetMarketSettingsDto:
      type: object
      properties:
        asset:
          type: string
          minLength: 1
          description: >-
            Asset identifier: base symbol (e.g. "ETH") or full pair (e.g.
            "ETHUSDC").
          example: ETH
        data:
          description: >-
            Venue-specific limits for this market, passed through as the venue
            reports them. Aster returns leverageOiRemainingMap: the notional
            still openable platform-wide at each leverage tier, keyed by the
            highest leverage in the tier. Null when the venue reports no such
            limits or when reading them failed, so guard before you read a
            field.
        exchange:
          type: string
          enum:
            - aster
            - binance
            - bybit
            - extended
            - gate
            - hyperliquid
            - lighter
            - mexc
            - ondo
            - robinhood
          description: Perpetual exchange
        leverage:
          type: number
          exclusiveMinimum: 0
        marginMode:
          type: string
          enum:
            - isolated
            - cross
        maxLeverage:
          description: Highest leverage your account can use on this market.
          example: 50
          type: number
          exclusiveMinimum: 0
      required:
        - asset
        - data
        - exchange
        - leverage
        - marginMode
      title: MarketSettings
    ErrorResponseDTO:
      type: object
      properties:
        message:
          type: string
          example: 'Invalid order id: 123'
        statusCode:
          example: 503
          type: number
      required:
        - message
      title: ErrorResponse
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

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