v1

latestOpenAPI 3.0.32026-07-267278168.1 KB

Margin Account

Get Max Order Size

Get a summary of the maximum order size that can be placed given the current state of the order book and available margin. For how size limits are determined, see Position size limits.

get/v1/perps/max_order_size

Query parameters

marketstring required

Example:AAPL-USD.P

Market to estimate max order size for

bufferstring

Example:0.9

Factor to scale returned sizes to guard against fluctuations between calling this endpoint and placing the order. Must be a decimal between 0 and 1. Defaults to 0.9.

Response

Maximum order sizes

successboolean required

Whether the request was successful

errorstring

Error message, present only on failure

error_codestring

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecatedstring

Deprecation notice, if applicable

Example response

{
  "success": true,
  "result": {
    "percent100": {
      "maxBidBaseSize": "123.4",
      "maxAskBaseSize": "123.4"
    },
    "percent75": {
      "maxBidBaseSize": "123.4",
      "maxAskBaseSize": "123.4"
    },
    "percent50": {
      "maxBidBaseSize": "123.4",
      "maxAskBaseSize": "123.4"
    },
    "percent25": {
      "maxBidBaseSize": "123.4",
      "maxAskBaseSize": "123.4"
    }
  }
}