spot.account

async def info(
  self,
  *,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> SpotAccountInfo:
  """Returns trading permissions and spot balances for the signed account.

  Args:
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/account', params=params)
  return self.output(r.text, adapter, validate)

async def kyc_status(
  self,
  *,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> KycStatusResponse:
  """Returns the account KYC verification tier for the signed spot account.

  Args:
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-kyc-status)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/kyc/status', params=params)
  return self.output(r.text, adapter, validate)

async def mx_deduct_enable(
  self,
  *,
  mx_deduct_enable: bool,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> MxDeductEnableResponse:
  """Enables or disables MX deduction for spot commission fees.

  Args:
    mx_deduct_enable: Set true to enable MX deduction, false to disable it.
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#enable-mx-deduct)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if mx_deduct_enable is not None:
    params['mxDeductEnable'] = mx_deduct_enable
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('POST', '/api/v3/mxDeduct/enable', params=params)
  return self.output(r.text, adapter, validate)

async def mx_deduct_status(
  self,
  *,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> MxDeductStatusResponse:
  """Returns whether MX deduction for spot commission fees is enabled.

  Args:
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-mx-deduct-status)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/mxDeduct/enable', params=params)
  return self.output(r.text, adapter, validate)

async def open_orders(
  self,
  *,
  symbol: str,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> list[OpenOrder]:
  """Returns open orders for a signed account and symbol.

  Args:
    symbol: Spot symbol.
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#current-open-orders)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if symbol is not None:
    params['symbol'] = symbol
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/openOrders', params=params)
  return self.output(r.text, adapter, validate)

async def order(
  self,
  *,
  symbol: str | None = None,
  orig_client_order_id: str | None = None,
  order_id: str | None = None,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> OrderStatus:
  """Returns status and fill information for one order.

  Args:
    symbol: Spot symbol.
    orig_client_order_id: Original client order id.
    order_id: Order id.
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-order)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if symbol is not None:
    params['symbol'] = symbol
  if orig_client_order_id is not None:
    params['origClientOrderId'] = orig_client_order_id
  if order_id is not None:
    params['orderId'] = order_id
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/order', params=params)
  return self.output(r.text, adapter, validate)

async def orders(
  self,
  *,
  symbol: str,
  start_time: Timestamp | None = None,
  end_time: Timestamp | None = None,
  limit: int | None = None,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> list[OrderStatus]:
  """Returns active, canceled, and completed orders for a symbol in a bounded time window.

  Args:
    symbol: Spot symbol.
    start_time: Window start time in milliseconds.
    end_time: Window end time in milliseconds.
    limit: Default 500; maximum 1000.
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if symbol is not None:
    params['symbol'] = symbol
  if start_time is not None:
    params['startTime'] = ts.dump_ms(start_time)
  if end_time is not None:
    params['endTime'] = ts.dump_ms(end_time)
  if limit is not None:
    params['limit'] = limit
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/allOrders', params=params)
  return self.output(r.text, adapter, validate)

async def self_symbols(
  self,
  *,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> SelfSymbolsResponse:
  """Returns the symbols enabled for the signed API key.

  Args:
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#user-api-default-symbol)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/selfSymbols', params=params)
  return self.output(r.text, adapter, validate)

async def trade_fee(
  self,
  *,
  symbol: str,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> TradeFeeResponse:
  """Returns maker and taker commission rates for a symbol.

  Args:
    symbol: Spot symbol whose commission rates should be returned.
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-symbol-commission)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if symbol is not None:
    params['symbol'] = symbol
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/tradeFee', params=params)
  return self.output(r.text, adapter, validate)

async def trades(
  self,
  *,
  symbol: str,
  order_id: str | None = None,
  start_time: Timestamp | None = None,
  end_time: Timestamp | None = None,
  limit: int | None = None,
  recv_window: int | None = None,
  timestamp: Timestamp | None = None,
  validate: bool | None = None
) -> list[AccountTrade]:
  """Returns account trade executions for a symbol, limited to recent history.

  Args:
    symbol: Spot symbol.
    order_id: Order id filter.
    start_time: Window start time.
    end_time: Window end time.
    limit: Default 100; maximum 100.
    recv_window: Optional receive window in milliseconds; maximum 60000.
    timestamp: Signed request timestamp in milliseconds.
    validate: Validation override for this request.

  Returns:
    The validated endpoint response.

  References:
    - [MEXC API docs](https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-trade-list)
  """
  if timestamp is None:
    timestamp = ts.now()
  params = {}
  if symbol is not None:
    params['symbol'] = symbol
  if order_id is not None:
    params['orderId'] = order_id
  if start_time is not None:
    params['startTime'] = ts.dump_ms(start_time)
  if end_time is not None:
    params['endTime'] = ts.dump_ms(end_time)
  if limit is not None:
    params['limit'] = limit
  if recv_window is not None:
    params['recvWindow'] = recv_window
  if timestamp is not None:
    params['timestamp'] = ts.dump_ms(timestamp)
  r = await self.signed_request('GET', '/api/v3/myTrades', params=params)
  return self.output(r.text, adapter, validate)