Get Maximum Buy/Sell Quantity

GET /api/v1/crypto/accounts/{acc_id}/purchasing-power

Query the maximum buy/sell quantity and amount for a specified account.

Path Parameters

Parameter	Type	Required	Description
acc_id	uint64	Yes	Account ID

Request Parameters

Parameter	Type	Location	Required	Description
order_type	string	Query	No	Order type. See Naming Dictionary for valid values.
currency	string	Query	No	Settlement currency, e.g. USD
coin	string	Query	No	Trading asset, e.g. BTC
price	string	Query	Conditional	Limit price. Required and must be greater than 0 when order_type is LIMIT, TAKE_PROFIT_LIMIT, or STOP_LOSS_LIMIT.

Response Parameters

Field	Type	Description
max_cash_buy_qty	string	Maximum buy quantity using cash
max_sell_qty	string	Maximum sell quantity
max_cash_buy_amount	string	Maximum buy amount using cash

Request Example

curl -X GET "https://webapi.futunn.com/api/v1/crypto/accounts/123456/purchasing-power?order_type=LIMIT&currency=USD&coin=BTC&price=30000" \
  -H "X-Api-Key: <AppKey>" \
  -H "X-Timestamp: <timestamp_ms>" \
  -H "X-Nonce: <nonce>" \
  -H "Authorization: <signature_base64>"

Response Example

{
  "code": 0,
  "msg": "success",
  "data": {
    "max_cash_buy_qty": "0.033",
    "max_sell_qty": "1.5",
    "max_cash_buy_amount": "990.00"
  }
}

Error Response:

{
  "code": 1,
  "msg": "Error message."
}