walrasquant-lib 0.4.20__py3-none-any.whl

walrasquant/exchange/binance/rest_api.py

@@ -0,0 +1,1653 @@
+import hmac
+import hashlib
+import msgspec
+
+from typing import Any
+from urllib.parse import urljoin, urlencode
+import asyncio
+import aiohttp
+import yarl
+
+from walrasquant.base import ApiClient, RetryManager
+from walrasquant.exchange.binance.schema import (
+    BinanceOrder,
+    BinanceListenKey,
+    BinanceSpotAccountInfo,
+    BinanceFuturesAccountInfo,
+    BinanceResponseKline,
+    BinanceFuturesModifyOrderResponse,
+    BinanceCancelAllOrdersResponse,
+    BinanceFundingRateResponse,
+    BinancePortfolioMarginBalance,
+    BinancePortfolioMarginPositionRisk,
+    BinanceIndexResponseKline,
+    BinanceBatchOrderResponse,
+    BinanceFuture24hrTicker,
+    BinanceSpot24hrTicker,
+    BinanceDepthSnapshotData,
+    BinanceBnbTransferResponse,
+)
+from walrasquant.exchange.binance.constants import (
+    BinanceAccountType,
+    BinanceRateLimiter,
+)
+from walrasquant.exchange.binance.error import BinanceClientError, BinanceServerError
+from walrasquant.core.nautilius_core import hmac_signature, LiveClock
+
+
+class BinanceApiClient(ApiClient):
+    _limiter: BinanceRateLimiter
+
+    def __init__(
+        self,
+        clock: LiveClock,
+        api_key: str | None = None,
+        secret: str | None = None,
+        testnet: bool = False,
+        timeout: int = 10,
+        enable_rate_limit: bool = True,
+        max_retries: int = 0,
+        delay_initial_ms: int = 100,
+        delay_max_ms: int = 800,
+        backoff_factor: int = 2,
+    ):
+        super().__init__(
+            clock=clock,
+            api_key=api_key,
+            secret=secret,
+            timeout=timeout,
+            rate_limiter=BinanceRateLimiter(enable_rate_limit),
+            retry_manager=RetryManager(
+                max_retries=max_retries,
+                delay_initial_ms=delay_initial_ms,
+                delay_max_ms=delay_max_ms,
+                backoff_factor=backoff_factor,
+                exc_types=(BinanceClientError, BinanceServerError),
+                retry_check=lambda e: e.code in [-1000, -1001],
+            ),
+        )
+        self._headers = {
+            "Content-Type": "application/json",
+            "User-Agent": "TradingBot/1.0",
+        }
+
+        if api_key:
+            self._headers["X-MBX-APIKEY"] = api_key
+
+        self._testnet = testnet
+        self._msg_encoder = msgspec.json.Encoder()
+        self._msg_decoder = msgspec.json.Decoder()
+        self._order_decoder = msgspec.json.Decoder(BinanceOrder)
+        self._spot_account_decoder = msgspec.json.Decoder(BinanceSpotAccountInfo)
+        self._futures_account_decoder = msgspec.json.Decoder(BinanceFuturesAccountInfo)
+        self._listen_key_decoder = msgspec.json.Decoder(BinanceListenKey)
+        self._kline_response_decoder = msgspec.json.Decoder(list[BinanceResponseKline])
+        self._index_kline_response_decoder = msgspec.json.Decoder(
+            list[BinanceIndexResponseKline]
+        )
+        self._futures_modify_order_decoder = msgspec.json.Decoder(
+            BinanceFuturesModifyOrderResponse
+        )
+        self._cancel_all_orders_decoder = msgspec.json.Decoder(
+            BinanceCancelAllOrdersResponse
+        )
+        self._funding_rate_decoder = msgspec.json.Decoder(
+            list[BinanceFundingRateResponse]
+        )
+        self._portfolio_margin_balance_decoder = msgspec.json.Decoder(
+            list[BinancePortfolioMarginBalance]
+        )
+        self._portfolio_margin_position_risk_decoder = msgspec.json.Decoder(
+            list[BinancePortfolioMarginPositionRisk]
+        )
+        self._batch_order_decoder = msgspec.json.Decoder(
+            list[BinanceBatchOrderResponse]
+        )
+        self._single_future_24hr_ticker_decoder = msgspec.json.Decoder(
+            BinanceFuture24hrTicker
+        )
+        self._future_24hr_ticker_decoder = msgspec.json.Decoder(
+            list[BinanceFuture24hrTicker]
+        )
+        self._single_spot_24hr_ticker_decoder = msgspec.json.Decoder(
+            BinanceSpot24hrTicker
+        )
+        self._spot_24hr_ticker_decoder = msgspec.json.Decoder(
+            list[BinanceSpot24hrTicker]
+        )
+        self._depth_snapshot_decoder = msgspec.json.Decoder(BinanceDepthSnapshotData)
+        self._bnb_transfer_decoder = msgspec.json.Decoder(BinanceBnbTransferResponse)
+
+    def _generate_signature(self, query: str) -> str:
+        secret = self._secret
+        if secret is None:
+            raise ValueError("secret is required for signed Binance requests")
+        signature = hmac.new(
+            secret.encode("utf-8"), query.encode("utf-8"), hashlib.sha256
+        ).hexdigest()
+        return signature
+
+    def _generate_signature_v2(self, query: str) -> str:
+        secret = self._secret
+        if secret is None:
+            raise ValueError("secret is required for signed Binance requests")
+        signature = hmac_signature(secret, query)
+        return signature
+
+    async def _fetch(
+        self,
+        method: str,
+        base_url: str,
+        endpoint: str,
+        payload: dict[str, Any] | None = None,
+        signed: bool = False,
+        required_timestamp: bool = True,
+    ) -> Any:
+        retry_manager = self._retry_manager
+        if retry_manager is None:
+            raise ValueError("retry_manager is not configured")
+        return await retry_manager.run(
+            name=f"{method} {endpoint}",
+            func=self._fetch_async,
+            method=method,
+            base_url=base_url,
+            endpoint=endpoint,
+            payload=payload,
+            signed=signed,
+            required_timestamp=required_timestamp,
+        )
+
+    async def _fetch_async(
+        self,
+        method: str,
+        base_url: str,
+        endpoint: str,
+        payload: dict[str, Any] | None = None,
+        signed: bool = False,
+        required_timestamp: bool = True,
+    ) -> Any:
+        await self._init_session()
+        session = self._session
+        if session is None:
+            raise ValueError("HTTP session initialization failed")
+
+        url = urljoin(base_url, endpoint)
+        params = payload or {}
+        if required_timestamp:
+            params["timestamp"] = self._clock.timestamp_ms()
+        query = urlencode(params)
+
+        if signed:
+            signature = self._generate_signature_v2(query)
+            query += f"&signature={signature}"
+
+        # if method == "GET":
+        url = f"{url}?{query}"
+        data = None
+        # else:
+        #     data = payload
+        self._log.debug(f"Request: {url}")
+
+        try:
+            async with session.request(
+                method=method,
+                url=yarl.URL(url, encoded=True),
+                headers=self._headers,
+                data=data,
+            ) as response:
+                raw = await response.read()
+                if response.status >= 400:
+                    try:
+                        error_msg = self._msg_decoder.decode(raw) if raw else {}
+                    except msgspec.DecodeError:
+                        error_msg = raw.decode()
+
+                    if response.status >= 500:
+                        msg = (
+                            error_msg.get("msg", str(error_msg))
+                            if isinstance(error_msg, dict)
+                            else str(error_msg)
+                        )
+                        raise BinanceServerError(
+                            code=int(response.status),
+                            message=msg,
+                        )
+                    else:
+                        if not isinstance(error_msg, dict):
+                            raise BinanceClientError(
+                                code=int(response.status),
+                                message=str(error_msg),
+                            )
+                        raise BinanceClientError(
+                            code=int(error_msg.get("code", response.status)),
+                            message=error_msg.get("msg", "Unknown error"),
+                        )
+                return raw
+        except asyncio.TimeoutError as e:
+            self._log.error(f"Timeout {method} {url} {e}")
+            raise
+        except aiohttp.ClientError as e:
+            self._log.error(f"Request Error {method} {url} {e}")
+            raise
+        except Exception as e:
+            self._log.error(f"Error {method} {url} {e}")
+            raise
+
+    def _get_base_url(self, account_type: BinanceAccountType) -> str:
+        if account_type == BinanceAccountType.SPOT:
+            if self._testnet:
+                return BinanceAccountType.SPOT_TESTNET.base_url
+            return BinanceAccountType.SPOT.base_url
+        elif account_type == BinanceAccountType.MARGIN:
+            return BinanceAccountType.MARGIN.base_url
+        elif account_type == BinanceAccountType.ISOLATED_MARGIN:
+            return BinanceAccountType.ISOLATED_MARGIN.base_url
+        elif account_type == BinanceAccountType.USD_M_FUTURE:
+            if self._testnet:
+                return BinanceAccountType.USD_M_FUTURE_TESTNET.base_url
+            return BinanceAccountType.USD_M_FUTURE.base_url
+        elif account_type == BinanceAccountType.COIN_M_FUTURE:
+            if self._testnet:
+                return BinanceAccountType.COIN_M_FUTURE_TESTNET.base_url
+            return BinanceAccountType.COIN_M_FUTURE.base_url
+        elif account_type == BinanceAccountType.PORTFOLIO_MARGIN:
+            return BinanceAccountType.PORTFOLIO_MARGIN.base_url
+        raise ValueError(f"Unsupported Binance account type: {account_type}")
+
+    async def put_dapi_v1_listen_key(self):
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Keepalive-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/listenKey"
+        await self._limiter.dapi_weight_limit(cost=1)
+        raw = await self._fetch("PUT", base_url, end_point, required_timestamp=False)
+        return self._msg_decoder.decode(raw)
+
+    async def post_dapi_v1_listen_key(self):
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/user-data-streams/Start-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/listenKey"
+        await self._limiter.dapi_weight_limit(cost=1)
+        raw = await self._fetch("POST", base_url, end_point, required_timestamp=False)
+        return self._listen_key_decoder.decode(raw)
+
+    async def post_api_v3_user_data_stream(self) -> BinanceListenKey:
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/rest-api/user-data-stream-endpoints-deprecated
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/userDataStream"
+        await self._limiter.api_weight_limit(cost=2)
+        raw = await self._fetch("POST", base_url, end_point, required_timestamp=False)
+        return self._listen_key_decoder.decode(raw)
+
+    async def put_api_v3_user_data_stream(self, listen_key: str):
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/user-data-stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/userDataStream"
+        await self._limiter.api_weight_limit(cost=2)
+        raw = await self._fetch(
+            "PUT",
+            base_url,
+            end_point,
+            payload={"listenKey": listen_key},
+            required_timestamp=False,
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def post_sapi_v1_user_data_stream(self) -> BinanceListenKey:
+        """
+        https://developers.binance.com/docs/margin_trading/trade-data-stream/Start-Margin-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.MARGIN)
+        end_point = "/sapi/v1/userDataStream"
+        await self._limiter.api_weight_limit(cost=1)
+        raw = await self._fetch("POST", base_url, end_point, required_timestamp=False)
+        return self._listen_key_decoder.decode(raw)
+
+    async def put_sapi_v1_user_data_stream(self, listen_key: str):
+        """
+        https://developers.binance.com/docs/margin_trading/trade-data-stream/Keepalive-Margin-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.MARGIN)
+        end_point = "/sapi/v1/userDataStream"
+        await self._limiter.api_weight_limit(cost=1)
+        raw = await self._fetch(
+            "PUT",
+            base_url,
+            end_point,
+            payload={"listenKey": listen_key},
+            required_timestamp=False,
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def post_sapi_v1_user_data_stream_isolated(
+        self, symbol: str
+    ) -> BinanceListenKey:
+        """
+        https://developers.binance.com/docs/margin_trading/trade-data-stream/Start-Isolated-Margin-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.ISOLATED_MARGIN)
+        end_point = "/sapi/v1/userDataStream/isolated"
+        await self._limiter.api_weight_limit(cost=1)
+        raw = await self._fetch(
+            "POST",
+            base_url,
+            end_point,
+            payload={"symbol": symbol},
+            required_timestamp=False,
+        )
+        return self._listen_key_decoder.decode(raw)
+
+    async def put_sapi_v1_user_data_stream_isolated(self, symbol: str, listen_key: str):
+        """
+        https://developers.binance.com/docs/margin_trading/trade-data-stream/Keepalive-Isolated-Margin-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.ISOLATED_MARGIN)
+        end_point = "/sapi/v1/userDataStream/isolated"
+        await self._limiter.api_weight_limit(cost=1)
+        raw = await self._fetch(
+            "PUT",
+            base_url,
+            end_point,
+            payload={"symbol": symbol, "listenKey": listen_key},
+            required_timestamp=False,
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def post_fapi_v1_listen_key(self) -> BinanceListenKey:
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/user-data-streams/Start-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/listenKey"
+        await self._limiter.fapi_weight_limit(cost=1)
+        raw = await self._fetch("POST", base_url, end_point, required_timestamp=False)
+        return self._listen_key_decoder.decode(raw)
+
+    async def put_fapi_v1_listen_key(self):
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/user-data-streams/Keepalive-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/listenKey"
+        await self._limiter.fapi_weight_limit(cost=1)
+        raw = await self._fetch("PUT", base_url, end_point, required_timestamp=False)
+        return self._msg_decoder.decode(raw)
+
+    async def post_papi_v1_listen_key(self) -> BinanceListenKey:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/user-data-streams/Start-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/listenKey"
+        await self._limiter.papi_weight_limit(cost=1)
+        raw = await self._fetch("POST", base_url, end_point, required_timestamp=False)
+        return self._listen_key_decoder.decode(raw)
+
+    async def put_papi_v1_listen_key(self):
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/user-data-streams/Keepalive-User-Data-Stream
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/listenKey"
+        await self._limiter.papi_weight_limit(cost=1)
+        raw = await self._fetch("PUT", base_url, end_point, required_timestamp=False)
+        return self._msg_decoder.decode(raw)
+
+    async def post_sapi_v1_margin_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/margin_trading/trade/Margin-Account-New-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.MARGIN)
+        end_point = "/sapi/v1/margin/order"
+        await self._limiter.api_order_limit(cost=6)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def post_api_v3_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/rest-api/public-api-endpoints#new-order-trade
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/order"
+        await self._limiter.api_order_limit(cost=1)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def post_fapi_v1_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/rest-api
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/order"
+        await self._limiter.fapi_order_limit()
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def post_dapi_v1_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/order"
+        await self._limiter.dapi_order_limit()
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def post_papi_v1_bnb_transfer(
+        self,
+        amount: str,
+        transferSide: str,
+        **kwargs,
+    ) -> BinanceBnbTransferResponse:
+        """
+        Transfer BNB in and out of UM.
+        https://developers.binance.com/docs/derivatives/portfolio-margin/transfer/BNB-Transfer
+        POST /papi/v1/bnb-transfer
+        Weight: 750 — max 10 calls per 10 minutes
+        transferSide: "TO_UM" or "FROM_UM"
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/bnb-transfer"
+        await self._limiter.papi_weight_limit(750)
+        data = {"amount": amount, "transferSide": transferSide, **kwargs}
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._bnb_transfer_decoder.decode(raw)
+
+    async def post_papi_v1_um_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/order"
+        await self._limiter.papi_order_limit(cost=1)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def post_papi_v1_cm_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/New-CM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/order"
+        await self._limiter.papi_order_limit(cost=1)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def post_papi_v1_margin_order(
+        self,
+        symbol: str,
+        side: str,
+        type: str,
+        **kwargs,
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/New-Margin-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/margin/order"
+        await self._limiter.papi_order_limit(cost=1)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "type": type,
+            **kwargs,
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def delete_api_v3_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-UM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def delete_sapi_v1_margin_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/margin_trading/trade/Margin-Account-Cancel-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.MARGIN)
+        end_point = "/sapi/v1/margin/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def delete_sapi_v1_margin_open_orders(self, symbol: str, **kwargs):
+        """
+        https://developers.binance.com/docs/margin_trading/trade/Margin-Account-Cancel-All-Open-Orders
+        DELETE /sapi/v1/margin/openOrders
+        """
+        base_url = self._get_base_url(BinanceAccountType.MARGIN)
+        end_point = "/sapi/v1/margin/openOrders"
+        data = {
+            "symbol": symbol,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def delete_fapi_v1_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/rest-api/Cancel-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def delete_dapi_v1_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def delete_papi_v1_um_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-UM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def delete_papi_v1_cm_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-CM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def delete_papi_v1_margin_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-Margin-Account-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/margin/order"
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._order_decoder.decode(raw)
+
+    async def get_api_v3_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/rest-api/account-endpoints#query-order-user_data
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/order"
+        await self._limiter.api_weight_limit(4)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_sapi_v1_margin_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/margin_trading/trade/Query-Margin-Account-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.MARGIN)
+        end_point = "/sapi/v1/margin/order"
+        await self._limiter.api_weight_limit(10)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_fapi_v1_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/rest-api/Query-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/order"
+        await self._limiter.fapi_weight_limit(1)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_dapi_v1_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Query-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/order"
+        await self._limiter.dapi_weight_limit(1)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_papi_v1_um_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Query-UM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/order"
+        await self._limiter.papi_weight_limit(1)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_papi_v1_cm_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Query-CM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/order"
+        await self._limiter.papi_weight_limit(1)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_papi_v1_margin_order(
+        self, symbol: str, origClientOrderId: str, **kwargs
+    ) -> BinanceOrder:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Query-Margin-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/margin/order"
+        await self._limiter.papi_weight_limit(10)
+        data = {
+            "symbol": symbol,
+            "origClientOrderId": origClientOrderId,
+            **kwargs,
+        }
+        raw = await self._fetch("GET", base_url, end_point, payload=data, signed=True)
+        return self._order_decoder.decode(raw)
+
+    async def get_api_v3_account(self) -> BinanceSpotAccountInfo:
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/rest-api/account-endpoints#account-information-user_data
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/account"
+        await self._limiter.api_weight_limit(20)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._spot_account_decoder.decode(raw)
+
+    async def get_fapi_v2_account(self) -> BinanceFuturesAccountInfo:
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/account/rest-api/Account-Information-V2
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v2/account"
+        await self._limiter.fapi_weight_limit(5)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._futures_account_decoder.decode(raw)
+
+    async def get_dapi_v1_account(self) -> BinanceFuturesAccountInfo:
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/account/rest-api/Account-Information
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/account"
+        await self._limiter.dapi_weight_limit(5)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._futures_account_decoder.decode(raw)
+
+    async def get_papi_v1_balance(self) -> list[BinancePortfolioMarginBalance]:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/account
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/balance"
+        await self._limiter.papi_weight_limit(20)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._portfolio_margin_balance_decoder.decode(raw)
+
+    async def get_papi_v1_um_position_risk(
+        self,
+    ) -> list[BinancePortfolioMarginPositionRisk]:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/account/Query-UM-Position-Information
+        /papi/v1/um/positionRisk
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/positionRisk"
+        await self._limiter.papi_weight_limit(5)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._portfolio_margin_position_risk_decoder.decode(raw)
+
+    async def get_papi_v1_cm_position_risk(
+        self,
+    ) -> list[BinancePortfolioMarginPositionRisk]:
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/account/Query-CM-Position-Information
+        /papi/v1/cm/positionRisk
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/positionRisk"
+        await self._limiter.papi_weight_limit(1)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._portfolio_margin_position_risk_decoder.decode(raw)
+
+    async def get_fapi_v1_klines(
+        self,
+        symbol: str,
+        interval: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/rest-api/Kline-Candlestick-Data
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/klines"
+        if limit is None:  # default limit is 500
+            cost = 5
+        elif limit < 100:
+            cost = 1
+        elif limit < 500:
+            cost = 2
+        elif limit < 1000:
+            cost = 5
+        else:
+            cost = 10
+
+        await self._limiter.fapi_weight_limit(cost)
+
+        data: dict[str, int | str] = {
+            "symbol": symbol,
+            "interval": interval,
+        }
+
+        if startTime is not None:
+            data["startTime"] = startTime
+        if endTime is not None:
+            data["endTime"] = endTime
+        if limit is not None:
+            data["limit"] = limit
+
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=data, required_timestamp=False
+        )
+        return self._kline_response_decoder.decode(raw)
+
+    async def get_dapi_v1_klines(
+        self,
+        symbol: str,
+        interval: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Kline-Candlestick-Data
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/klines"
+
+        if limit is None:  # default limit is 500
+            cost = 5
+        elif limit < 100:
+            cost = 1
+        elif limit < 500:
+            cost = 2
+        elif limit < 1000:
+            cost = 5
+        else:
+            cost = 10
+
+        await self._limiter.dapi_weight_limit(cost)
+
+        data = {
+            "symbol": symbol,
+            "interval": interval,
+            "startTime": startTime,
+            "endTime": endTime,
+            "limit": limit,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=data, required_timestamp=False
+        )
+        return self._kline_response_decoder.decode(raw)
+
+    async def get_fapi_v1_index_price_klines(
+        self,
+        pair: str,
+        interval: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/indexPriceKlines"
+        if limit is None:  # default limit is 500
+            cost = 5
+        elif limit < 100:
+            cost = 1
+        elif limit < 500:
+            cost = 2
+        elif limit < 1000:
+            cost = 5
+        else:
+            cost = 10
+
+        await self._limiter.fapi_weight_limit(cost)
+        data = {
+            "pair": pair,
+            "interval": interval,
+            "startTime": startTime,
+            "endTime": endTime,
+            "limit": limit,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=data, required_timestamp=False
+        )
+        return self._index_kline_response_decoder.decode(raw)
+
+    async def get_dapi_v1_index_price_klines(
+        self,
+        pair: str,
+        interval: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/indexPriceKlines"
+        if limit is None:  # default limit is 500
+            cost = 5
+        elif limit < 100:
+            cost = 1
+        elif limit < 500:
+            cost = 2
+        elif limit < 1000:
+            cost = 5
+        else:
+            cost = 10
+
+        await self._limiter.dapi_weight_limit(cost)
+        data = {
+            "pair": pair,
+            "interval": interval,
+            "startTime": startTime,
+            "endTime": endTime,
+            "limit": limit,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=data, required_timestamp=False
+        )
+        return self._index_kline_response_decoder.decode(raw)
+
+    async def get_api_v3_klines(
+        self,
+        symbol: str,
+        interval: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/rest-api/market-data-endpoints#klinecandlestick-data
+
+        [
+            [
+                1499040000000,      // Kline open time
+                "0.01634790",       // Open price
+                "0.80000000",       // High price
+                "0.01575800",       // Low price
+                "0.01577100",       // Close price
+                "148976.11427815",  // Volume
+                1499644799999,      // Kline Close time
+                "2434.19055334",    // Quote asset volume
+                308,                // Number of trades
+                "1756.87402397",    // Taker buy base asset volume
+                "28.46694368",      // Taker buy quote asset volume
+                "0"                 // Unused field, ignore.
+            ]
+        ]
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/klines"
+        data: dict[str, str | int] = {
+            "symbol": symbol,
+            "interval": interval,
+        }
+
+        await self._limiter.api_weight_limit(2)
+
+        if startTime is not None:
+            data["startTime"] = startTime
+        if endTime is not None:
+            data["endTime"] = endTime
+        if limit is not None:
+            data["limit"] = limit
+
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=data, required_timestamp=False
+        )
+        return self._kline_response_decoder.decode(raw)
+
+    async def put_fapi_v1_order(
+        self,
+        symbol: str,
+        side: str,
+        quantity: str,
+        price: str,
+        orderId: int | None = None,
+        origClientOrderId: str | None = None,
+        priceMatch: str | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/rest-api/Modify-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/order"
+        await self._limiter.fapi_order_limit()
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "quantity": quantity,
+            "price": price,
+            "orderId": orderId,
+            "origClientOrderId": origClientOrderId,
+            "priceMatch": priceMatch,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch("PUT", base_url, end_point, payload=data, signed=True)
+        return self._futures_modify_order_decoder.decode(raw)
+
+    async def put_dapi_v1_order(
+        self,
+        symbol: str,
+        side: str,
+        quantity: str,
+        price: str,
+        orderId: int | None = None,
+        origClientOrderId: str | None = None,
+        priceMatch: str | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Modify-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/order"
+        await self._limiter.dapi_order_limit()
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "quantity": quantity,
+            "price": price,
+            "orderId": orderId,
+            "origClientOrderId": origClientOrderId,
+            "priceMatch": priceMatch,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch("PUT", base_url, end_point, payload=data, signed=True)
+        return self._futures_modify_order_decoder.decode(raw)
+
+    async def put_papi_v1_cm_order(
+        self,
+        symbol: str,
+        side: str,
+        quantity: str,
+        price: str,
+        orderId: int | None = None,
+        origClientOrderId: str | None = None,
+        priceMatch: str | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Modify-CM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/order"
+        await self._limiter.papi_order_limit(cost=1)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "quantity": quantity,
+            "price": price,
+            "orderId": orderId,
+            "origClientOrderId": origClientOrderId,
+            "priceMatch": priceMatch,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch("PUT", base_url, end_point, payload=data, signed=True)
+        return self._futures_modify_order_decoder.decode(raw)
+
+    async def put_papi_v1_um_order(
+        self,
+        symbol: str,
+        side: str,
+        quantity: str,
+        price: str,
+        orderId: int | None = None,
+        origClientOrderId: str | None = None,
+        priceMatch: str | None = None,
+    ):
+        """
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Modify-UM-Order
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/order"
+        await self._limiter.papi_order_limit(cost=1)
+        data = {
+            "symbol": symbol,
+            "side": side,
+            "quantity": quantity,
+            "price": price,
+            "orderId": orderId,
+            "origClientOrderId": origClientOrderId,
+            "priceMatch": priceMatch,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch("PUT", base_url, end_point, payload=data, signed=True)
+        return self._futures_modify_order_decoder.decode(raw)
+
+    async def delete_fapi_v1_all_open_orders(self, symbol: str):
+        """
+        DELETE /fapi/v1/allOpenOrders
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/trade/rest-api/Cancel-All-Open-Orders
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/allOpenOrders"
+        data = {
+            "symbol": symbol,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def delete_dapi_v1_all_open_orders(self, symbol: str):
+        """
+        DELETE /dapi/v1/allOpenOrders
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/trade/rest-api/Cancel-All-Open-Orders
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/allOpenOrders"
+        data = {
+            "symbol": symbol,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def delete_papi_v1_um_all_open_orders(self, symbol: str):
+        """
+        DELETE /papi/v1/um/allOpenOrders
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-All-UM-Open-Orders
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/allOpenOrders"
+        data = {
+            "symbol": symbol,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def delete_papi_v1_cm_all_open_orders(self, symbol: str):
+        """
+        DELETE /papi/v1/cm/allOpenOrders
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-All-CM-Open-Orders
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/allOpenOrders"
+        data = {
+            "symbol": symbol,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def delete_papi_v1_margin_all_open_orders(self, symbol: str):
+        """
+        DELETE /papi/v1/margin/allOpenOrders
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/Cancel-Margin-Account-All-Open-Orders-on-a-Symbol
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/margin/allOpenOrders"
+        data = {
+            "symbol": symbol,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def delete_api_v3_open_orders(self, symbol: str):
+        """
+        DELETE /api/v3/openOrders
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/openOrders"
+        data = {
+            "symbol": symbol,
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, end_point, payload=data, signed=True
+        )
+        return self._msg_decoder.decode(raw)
+
+    async def get_fapi_v1_funding_rate(
+        self,
+        symbol: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        """
+        GET /fapi/v1/fundingRate
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/fundingRate"
+        data = {
+            "symbol": symbol,
+            "startTime": startTime,
+            "endTime": endTime,
+            "limit": limit,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch("GET", base_url, end_point, payload=data)
+        return self._funding_rate_decoder.decode(raw)
+
+    async def get_dapi_v1_funding_rate(
+        self,
+        symbol: str,
+        startTime: int | None = None,
+        endTime: int | None = None,
+        limit: int | None = None,
+    ):
+        """
+        GET /dapi/v1/fundingRate
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/fundingRate"
+        data = {
+            "symbol": symbol,
+            "startTime": startTime,
+            "endTime": endTime,
+            "limit": limit,
+        }
+        data = {k: v for k, v in data.items() if v is not None}
+        raw = await self._fetch("GET", base_url, end_point, payload=data)
+        return self._funding_rate_decoder.decode(raw)
+
+    async def get_fapi_v1_positionSide_dual(self):
+        """
+        GET /fapi/v1/positionSide/dual
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/account/rest-api/Get-Current-Position-Mode
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/positionSide/dual"
+        await self._limiter.fapi_weight_limit(30)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._msg_decoder.decode(raw)
+
+    async def get_dapi_v1_positionSide_dual(self):
+        """
+        GET /dapi/v1/positionSide/dual
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/positionSide/dual"
+        await self._limiter.dapi_weight_limit(30)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._msg_decoder.decode(raw)
+
+    async def get_papi_v1_um_positionSide_dual(self):
+        """
+        GET /papi/v1/um/positionSide/dual
+        https://developers.binance.com/docs/derivatives/portfolio-margin/account/Get-UM-Current-Position-Mode
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/positionSide/dual"
+        await self._limiter.papi_weight_limit(30)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._msg_decoder.decode(raw)
+
+    async def get_papi_v1_cm_positionSide_dual(self):
+        """
+        GET /papi/v1/cm/positionSide/dual
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/cm/positionSide/dual"
+        await self._limiter.papi_weight_limit(30)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._msg_decoder.decode(raw)
+
+    async def post_fapi_v1_batch_orders(
+        self,
+        batch_orders: list[dict],
+    ):
+        """
+        POST /fapi/v1/batchOrders
+        https://developers.binance.com/docs/zh-CN/derivatives/usds-margined-futures/trade/rest-api/Place-Multiple-Orders
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/batchOrders"
+        await self._limiter.fapi_order_limit(cost=5, order_sec_cost=1, order_min_cost=5)
+        data = {
+            "batchOrders": self._msg_encoder.encode(batch_orders),
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._batch_order_decoder.decode(raw)
+
+    async def post_dapi_v1_batch_orders(
+        self,
+        batch_orders: list[dict],
+    ):
+        """
+        POST /dapi/v1/batchOrders
+        https://developers.binance.com/docs/zh-CN/derivatives/coin-margined-futures/trade/rest-api/Place-Multiple-Orders
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/batchOrders"
+        await self._limiter.dapi_order_limit(cost=5)
+        data = {
+            "batchOrders": self._msg_encoder.encode(batch_orders),
+        }
+        raw = await self._fetch("POST", base_url, end_point, payload=data, signed=True)
+        return self._batch_order_decoder.decode(raw)
+
+    async def delete_fapi_v1_batch_orders(
+        self, symbol: str, origClientOrderIdList: list[str]
+    ) -> list[BinanceBatchOrderResponse]:
+        """DELETE /fapi/v1/batchOrders — cancel up to 10 orders, same symbol"""
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        endpoint = "/fapi/v1/batchOrders"
+        payload = {
+            "symbol": symbol,
+            "origClientOrderIdList": self._msg_encoder.encode(origClientOrderIdList),
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, endpoint, payload=payload, signed=True
+        )
+        return self._batch_order_decoder.decode(raw)
+
+    async def delete_dapi_v1_batch_orders(
+        self, symbol: str, origClientOrderIdList: list[str]
+    ) -> list[BinanceBatchOrderResponse]:
+        """DELETE /dapi/v1/batchOrders — cancel up to 10 orders, same symbol"""
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        endpoint = "/dapi/v1/batchOrders"
+        payload = {
+            "symbol": symbol,
+            "origClientOrderIdList": self._msg_encoder.encode(origClientOrderIdList),
+        }
+        raw = await self._fetch(
+            "DELETE", base_url, endpoint, payload=payload, signed=True
+        )
+        return self._batch_order_decoder.decode(raw)
+
+    async def get_fapi_v1_ticker_24hr(
+        self, symbol: str | None = None
+    ) -> list[BinanceFuture24hrTicker]:
+        """
+        GET /fapi/v1/ticker/24hr
+
+        24hr ticker price change statistics.
+
+        Request Weight:
+        - 1 for a single symbol
+        - 40 when the symbol parameter is omitted
+
+        Args:
+            symbol: Symbol name (optional)
+
+        Returns:
+            list[BinanceFuture24hrTicker]: List of 24hr ticker data
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/ticker/24hr"
+
+        payload = {}
+        if symbol:
+            payload["symbol"] = symbol
+            cost = 1
+        else:
+            cost = 40
+
+        await self._limiter.fapi_weight_limit(cost)
+
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=payload, signed=False
+        )
+        if symbol:
+            return [self._single_future_24hr_ticker_decoder.decode(raw)]
+        return self._future_24hr_ticker_decoder.decode(raw)
+
+    async def get_dapi_v1_ticker_24hr(
+        self, symbol: str | None = None, pair: str | None = None
+    ) -> list[BinanceFuture24hrTicker]:
+        """
+        GET /dapi/v1/ticker/24hr
+
+        24hr ticker price change statistics.
+
+        Request Weight:
+        - 1 for a single symbol
+        - 40 when the symbol parameter is omitted
+
+        Args:
+            symbol: Symbol name (optional)
+            pair: Pair name (optional)
+
+        Returns:
+            list[BinanceFuture24hrTicker]: List of 24hr ticker data
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/ticker/24hr"
+
+        payload = {}
+        if symbol:
+            payload["symbol"] = symbol
+            cost = 1
+        elif pair:
+            payload["pair"] = pair
+            cost = 1
+        else:
+            cost = 40
+
+        await self._limiter.dapi_weight_limit(cost)
+
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=payload, signed=False
+        )
+        return self._future_24hr_ticker_decoder.decode(raw)
+
+    async def get_api_v3_ticker_24hr(
+        self, symbol: str | None = None, symbols: str | None = None
+    ) -> list[BinanceSpot24hrTicker]:
+        """
+        GET /api/v3/ticker/24hr
+
+        24hr ticker price change statistics.
+
+        Request Weight:
+        - 1 for a single symbol
+        - 2 for a symbols parameter
+        - 40 when no parameters are sent
+
+        Args:
+            symbol: Symbol name (optional)
+            symbols: Array of symbols (optional, format: ["BTCUSDT","BNBUSDT"])
+
+        Returns:
+            list[BinanceSpot24hrTicker]: List of 24hr ticker data
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/ticker/24hr"
+
+        payload = {}
+        if symbol:
+            payload["symbol"] = symbol
+            cost = 1
+        elif symbols:
+            payload["symbols"] = symbols
+            cost = 2
+        else:
+            cost = 40
+
+        await self._limiter.api_weight_limit(cost)
+
+        raw = await self._fetch_async(
+            "GET", base_url, end_point, payload=payload, signed=False
+        )
+        if symbol:
+            return [self._single_spot_24hr_ticker_decoder.decode(raw)]
+        return self._spot_24hr_ticker_decoder.decode(raw)
+
+    async def fapi_v1_adl_quantile(self):
+        """
+        GET /fapi/v1/adlQuantile
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/rest-api/ADL-Quantile
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/adlQuantile"
+        await self._limiter.fapi_weight_limit(5)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._msg_decoder.decode(raw)
+
+    async def papi_v1_um_adl_quantile(self):
+        """
+        GET /papi/v1/adlQuantile
+        https://developers.binance.com/docs/derivatives/portfolio-margin/trade/UM-Position-ADL-Quantile-Estimation
+        """
+        base_url = self._get_base_url(BinanceAccountType.PORTFOLIO_MARGIN)
+        end_point = "/papi/v1/um/adlQuantile"
+        await self._limiter.papi_weight_limit(5)
+        raw = await self._fetch_async("GET", base_url, end_point, signed=True)
+        return self._msg_decoder.decode(raw)
+
+    async def get_api_v3_depth(
+        self, symbol: str, limit: int = 1000
+    ) -> BinanceDepthSnapshotData:
+        """
+        https://developers.binance.com/docs/binance-spot-api-docs/rest-api/public-api-endpoints#order-book
+        """
+        base_url = self._get_base_url(BinanceAccountType.SPOT)
+        end_point = "/api/v3/depth"
+        await self._limiter.api_weight_limit(cost=10)
+        raw = await self._fetch(
+            "GET",
+            base_url,
+            end_point,
+            payload={"symbol": symbol, "limit": limit},
+            required_timestamp=False,
+        )
+        return self._depth_snapshot_decoder.decode(raw)
+
+    async def get_fapi_v1_depth(
+        self, symbol: str, limit: int = 1000
+    ) -> BinanceDepthSnapshotData:
+        """
+        https://developers.binance.com/docs/derivatives/usds-margined-futures/market-data/rest-api/Order-Book
+        """
+        base_url = self._get_base_url(BinanceAccountType.USD_M_FUTURE)
+        end_point = "/fapi/v1/depth"
+        await self._limiter.fapi_weight_limit(cost=10)
+        raw = await self._fetch(
+            "GET",
+            base_url,
+            end_point,
+            payload={"symbol": symbol, "limit": limit},
+            required_timestamp=False,
+        )
+        return self._depth_snapshot_decoder.decode(raw)
+
+    async def get_dapi_v1_depth(
+        self, symbol: str, limit: int = 1000
+    ) -> BinanceDepthSnapshotData:
+        """
+        https://developers.binance.com/docs/derivatives/coin-margined-futures/market-data/rest-api/Order-Book
+        """
+        base_url = self._get_base_url(BinanceAccountType.COIN_M_FUTURE)
+        end_point = "/dapi/v1/depth"
+        await self._limiter.dapi_weight_limit(cost=10)
+        raw = await self._fetch(
+            "GET",
+            base_url,
+            end_point,
+            payload={"symbol": symbol, "limit": limit},
+            required_timestamp=False,
+        )
+        return self._depth_snapshot_decoder.decode(raw)