v2

latestOpenAPI 3.0.02026-07-311824171.4 MB
Trading
Private

Calculates margin requirements for a hypothetical order on a given instrument. Returns initial margin and maintenance margin for the specified instrument, quantity, and price.

This method is useful for estimating margin requirements before placing an order, helping to ensure sufficient funds are available and understanding the margin impact of potential trades.

Scope: trade:read

Try in API console

get/private/get_margins

Query parameters

instrument_namestring required

Unique instrument identifier

Example:BTC-PERPETUAL

Instrument name

amountnumber required

It represents the requested order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

pricenumber required
Example:3725

Price

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "buy": 0.01681367,
    "sell": 0.01680479,
    "buy_taker_fee": 0.000017,
    "buy_maker_fee": 0.000017,
    "sell_taker_fee": 0.000017,
    "sell_maker_fee": 0.000017
  }
}