binance-connector-ruby 1.0.1

data/lib/binance/spot/bswap.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Binance
+  class Spot
+    # Bswap endpoints
+    # @see https://binance-docs.github.io/apidocs/spot/en/#bswap-endpoints
+    module Bswap
+      # List All Swap Pools (MARKET_DATA)
+      #
+      # GET /sapi/v1/bswap/pools
+      #
+      # @see https://binance-docs.github.io/apidocs/spot/en/#list-all-swap-pools-market_data
+      def swap_pools
+        @session.limit_request(path: '/sapi/v1/bswap/pools')
+      end
+
+      # Get liquidity information of a pool (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/liquidity
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :poolId
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-liquidity-information-of-a-pool-user_data
+      def get_liquidity_info(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/bswap/liquidity', params: kwargs)
+      end
+
+      # Add Liquidity (TRADE)
+      #
+      # POST /sapi/v1/bswap/liquidityAdd
+      #
+      # @param poolId [Integer]
+      # @param asset [String]
+      # @param quantity [Float]
+      # @param kwargs [Hash]
+      # @option kwargs [String] :type "Single" to add a single token; "Combination" to add dual tokens. Default "Single"
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#add-liquidity-trade
+      def add_liquidity(poolId:, asset:, quantity:, **kwargs)
+        Binance::Utils::Validation.require_param('poolId', poolId)
+        Binance::Utils::Validation.require_param('asset', asset)
+        Binance::Utils::Validation.require_param('quantity', quantity)
+
+        @session.sign_request(:post, '/sapi/v1/bswap/liquidityAdd', params: kwargs.merge(
+          poolId: poolId,
+          asset: asset,
+          quantity: quantity
+        ))
+      end
+
+      # Remove Liquidity (TRADE)
+      #
+      # POST /sapi/v1/bswap/liquidityRemove
+      #
+      # @param poolId [Integer]
+      # @param type [String] SINGLE for single asset removal, COMBINATION for combination of all coins removal
+      # @param shareAmount [Float]
+      # @param kwargs [Hash]
+      # @option kwargs [String Array] :asset Mandatory for single asset removal
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#remove-liquidity-trade
+      def remove_liquidity(poolId:, type:, shareAmount:, **kwargs)
+        Binance::Utils::Validation.require_param('poolId', poolId)
+        Binance::Utils::Validation.require_param('type', type)
+        Binance::Utils::Validation.require_param('shareAmount', shareAmount)
+
+        @session.sign_request(:post, '/sapi/v1/bswap/liquidityRemove', params: kwargs.merge(
+          poolId: poolId,
+          type: type,
+          shareAmount: shareAmount
+        ))
+      end
+
+      # Get Liquidity Operation Record (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/liquidityOps
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :operationId
+      # @option kwargs [Integer] :poolId
+      # @option kwargs [String] :operation ADD or REMOVE
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :limit default 3, max 100
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-liquidity-operation-record-user_data
+      def get_liquidity_operation_record(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/bswap/liquidityOps', params: kwargs)
+      end
+
+      # Request Quote (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/quote
+      #
+      # @param quoteAsset [String]
+      # @param baseAsset [String]
+      # @param quoteQty [Float]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#request-quote-user_data
+      def request_quote(quoteAsset:, baseAsset:, quoteQty:, **kwargs)
+        Binance::Utils::Validation.require_param('quoteAsset', quoteAsset)
+        Binance::Utils::Validation.require_param('baseAsset', baseAsset)
+        Binance::Utils::Validation.require_param('quoteQty', quoteQty)
+
+        @session.sign_request(:get, '/sapi/v1/bswap/quote', params: kwargs.merge(
+          quoteAsset: quoteAsset,
+          baseAsset: baseAsset,
+          quoteQty: quoteQty
+        ))
+      end
+
+      # Swap (TRADE)
+      #
+      # POST /sapi/v1/bswap/swap
+      #
+      # @param quoteAsset [String]
+      # @param baseAsset [String]
+      # @param quoteQty [Float]
+      # @param [Hash] kwargs
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#swap-trade
+      def swap(quoteAsset:, baseAsset:, quoteQty:, **kwargs)
+        Binance::Utils::Validation.require_param('quoteAsset', quoteAsset)
+        Binance::Utils::Validation.require_param('baseAsset', baseAsset)
+        Binance::Utils::Validation.require_param('quoteQty', quoteQty)
+
+        @session.sign_request(:post, '/sapi/v1/bswap/swap', params: kwargs.merge(
+          quoteAsset: quoteAsset,
+          baseAsset: baseAsset,
+          quoteQty: quoteQty
+        ))
+      end
+
+      # Get Swap History (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/swap
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :swapId
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :status 0: pending for swap, 1: success, 2: failed
+      # @option kwargs [String] :quoteAsset
+      # @option kwargs [String] :baseAsset
+      # @option kwargs [Integer] :limit
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-swap-history-user_data
+      def get_swap_history(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/bswap/swap', params: kwargs)
+      end
+
+      # Get Pool Configure (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/poolConfigure
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :poolId
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-pool-configure-user_data
+      def get_pool_config(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/bswap/poolConfigure', params: kwargs)
+      end
+
+      # Add Liquidity Preview (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/addLiquidityPreview
+      #
+      # @param poolId [Integer]
+      # @param type [String] "SINGLE" for adding a single token; "COMBINATION" for adding dual tokens
+      # @param quoteAsset [String]
+      # @param quoteQty [Float]
+      # @param [Hash] kwargs
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#add-liquidity-preview-user_data
+      def add_liquidity_preview(poolId:, type:, quoteAsset:, quoteQty:, **kwargs)
+        Binance::Utils::Validation.require_param('poolId', poolId)
+        Binance::Utils::Validation.require_param('type', type)
+        Binance::Utils::Validation.require_param('quoteAsset', quoteAsset)
+        Binance::Utils::Validation.require_param('quoteQty', quoteQty)
+
+        @session.sign_request(:get, '/sapi/v1/bswap/addLiquidityPreview', params: kwargs.merge(
+          poolId: poolId,
+          type: type,
+          quoteAsset: quoteAsset,
+          quoteQty: quoteQty
+        ))
+      end
+
+      # Remove Liquidity Preview (USER_DATA)
+      #
+      # GET /sapi/v1/bswap/removeLiquidityPreview
+      #
+      # @param poolId [Integer]
+      # @param type [String] "SINGLE" for removing a single token; "COMBINATION" for removing dual tokens
+      # @param quoteAsset [String]
+      # @param shareAmount [Float]
+      # @param [Hash] kwargs
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#remove-liquidity-preview-user_data
+      def remove_liquidity_preview(poolId:, type:, quoteAsset:, shareAmount:, **kwargs)
+        Binance::Utils::Validation.require_param('poolId', poolId)
+        Binance::Utils::Validation.require_param('type', type)
+        Binance::Utils::Validation.require_param('quoteAsset', quoteAsset)
+        Binance::Utils::Validation.require_param('shareAmount', shareAmount)
+
+        @session.sign_request(:get, '/sapi/v1/bswap/removeLiquidityPreview', params: kwargs.merge(
+          poolId: poolId,
+          type: type,
+          quoteAsset: quoteAsset,
+          shareAmount: shareAmount
+        ))
+      end
+    end
+  end
+end

data/lib/binance/spot/c2c.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Binance
+  class Spot
+    # C2C endpoints
+    # @see https://binance-docs.github.io/apidocs/spot/en/#c2c-endpoints
+    module C2C
+      # Get C2C Trade History (USER_DATA)
+      #
+      # GET /sapi/v1/c2c/orderMatch/listUserOrderHistory
+      #
+      # @param tradeType [String]
+      # @option kwargs [Integer] :startTimestamp
+      # @option kwargs [Integer] :endTimestamp
+      # @option kwargs [Integer] :page
+      # @option kwargs [Integer] :rows
+      # @option kwargs [Integer] :recvWindow
+      # @option kwargs [Integer] :timestamp
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-c2c-trade-history-user_data
+      def c2c_trade_history(tradeType:, **kwargs)
+        Binance::Utils::Validation.require_param('tradeType', tradeType)
+
+        @session.sign_request(:get, '/sapi/v1/c2c/orderMatch/listUserOrderHistory', params: kwargs.merge(tradeType: tradeType))
+      end
+    end
+  end
+end

data/lib/binance/spot/fiat.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Binance
+  class Spot
+    # Fiat endpoints
+    # @see https://binance-docs.github.io/apidocs/spot/en/#fiat-endpoints
+    module Fiat
+      # Get Fiat Deposit/Withdraw History (USER_DATA)
+      #
+      # GET /sapi/v1/fiat/orders
+      #
+      # @param transactionType [String] 0-deposit,1-withdraw
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :beginTime If beginTime and endTime are not sent, the recent 30-day data will be returned.
+      # @option kwargs [Integer] :endTime If beginTime and endTime are not sent, the recent 30-day data will be returned.
+      # @option kwargs [Integer] :page default 1
+      # @option kwargs [Integer] :rows default 100, max 500
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-fiat-deposit-withdraw-history-user_data
+      def fiat_deposit_withdraw_history(transactionType:, **kwargs)
+        Binance::Utils::Validation.require_param('transactionType', transactionType)
+
+        @session.sign_request(:get, '/sapi/v1/fiat/orders', params: kwargs.merge(
+          transactionType: transactionType
+        ))
+      end
+
+      # Get Fiat Payments History (USER_DATA)
+      #
+      # GET /sapi/v1/fiat/payments
+      #
+      # @param transactionType [String] 0-buy,1-sell
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :beginTime If beginTime and endTime are not sent, the recent 30-day data will be returned.
+      # @option kwargs [Integer] :endTime If beginTime and endTime are not sent, the recent 30-day data will be returned.
+      # @option kwargs [Integer] :page default 1
+      # @option kwargs [Integer] :rows default 100, max 500
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-fiat-payments-history-user_data
+      def fiat_payment_history(transactionType:, **kwargs)
+        Binance::Utils::Validation.require_param('transactionType', transactionType)
+
+        @session.sign_request(:get, '/sapi/v1/fiat/payments', params: kwargs.merge(
+          transactionType: transactionType
+        ))
+      end
+    end
+  end
+end

data/lib/binance/spot/futures.rb

@@ -0,0 +1,357 @@
+# frozen_string_literal: true
+
+module Binance
+  class Spot
+    # Futures endpoints
+    # @see https://binance-docs.github.io/apidocs/spot/en/#futures
+    module Futures
+      # New Future Account Transfer (USER_DATA)
+      #
+      # POST /sapi/v1/futures/transfer
+      #
+      # Execute transfer between spot account and futures account.
+      #
+      # @param asset [String]
+      # @param amount [Float]
+      # @param type [Integer] 1: transfer from spot account to USDT-M futures account. <br>
+      #   2: transfer from USDT-M futures account to spot account. <br>
+      #   3: transfer from spot account to COIN-M futures account. <br>
+      #   4: transfer from COIN-M futures account to spot account. <br>
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#new-future-account-transfer-user_data
+      def futures_account_transfer(asset:, amount:, type:, **kwargs)
+        Binance::Utils::Validation.require_param('asset', asset)
+        Binance::Utils::Validation.require_param('amount', amount)
+        Binance::Utils::Validation.require_param('type', type)
+
+        @session.sign_request(:post, '/sapi/v1/futures/transfer', params: kwargs.merge(
+          asset: asset,
+          amount: amount,
+          type: type
+        ))
+      end
+
+      # Get Future Account Transaction History List (USER_DATA)
+      #
+      # GET /sapi/v1/futures/transfer
+      #
+      # @param asset [String]
+      # @param startTime [Integer]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :current Currently querying page. Start from 1. Default:1
+      # @option kwargs [Integer] :size Default:10 Max:100
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-future-account-transaction-history-list-user_data
+      def futures_account_transfer_history(asset:, startTime:, **kwargs)
+        Binance::Utils::Validation.require_param('asset', asset)
+        Binance::Utils::Validation.require_param('startTime', startTime)
+
+        @session.sign_request(:get, '/sapi/v1/futures/transfer', params: kwargs.merge(
+          asset: asset,
+          startTime: startTime
+        ))
+      end
+
+      # Borrow For Cross-Collateral (TRADE)
+      #
+      # POST /sapi/v1/futures/loan/borrow
+      #
+      # @param coin [String]
+      # @param collateralCoin [String]
+      # @param kwargs [Hash]
+      # @option kwargs [Float] :amount Mandatory when collateralAmount is empty.
+      # @option kwargs [Float] :collateralAmount Mandatory when amount is empty.
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#borrow-for-cross-collateral-trade
+      def cross_collateral_borrow(coin:, collateralCoin:, **kwargs)
+        Binance::Utils::Validation.require_param('coin', coin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+
+        @session.sign_request(:post, '/sapi/v1/futures/loan/borrow', params: kwargs.merge(
+          coin: coin,
+          collateralCoin: collateralCoin
+        ))
+      end
+
+      # Cross-Collateral Borrow History (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/borrow/history
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [String] :coin
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :limit default 500, max 1000
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#cross-collateral-borrow-history-user_data
+      def cross_collateral_borrow_history(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/futures/loan/borrow/history', params: kwargs)
+      end
+
+      # Repay For Cross-Collateral (TRADE)
+      #
+      # POST /sapi/v1/futures/loan/repay
+      #
+      # @param coin [String]
+      # @param collateralCoin [String]
+      # @param amount [Float]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#repay-for-cross-collateral-trade
+      def cross_collateral_repay(coin:, collateralCoin:, amount:, **kwargs)
+        Binance::Utils::Validation.require_param('coin', coin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+        Binance::Utils::Validation.require_param('amount', amount)
+
+        @session.sign_request(:post, '/sapi/v1/futures/loan/repay', params: kwargs.merge(
+          coin: coin,
+          collateralCoin: collateralCoin,
+          amount: amount
+        ))
+      end
+
+      # Cross-Collateral Repayment History (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/repay/history
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [String] :coin
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :limit default 500, max 1000
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#cross-collateral-repayment-history-user_data
+      def cross_collateral_repay_history(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/futures/loan/repay/history', params: kwargs)
+      end
+
+      # Cross-Collateral Wallet (USER_DATA)
+      #
+      # GET /sapi/v2/futures/loan/wallet
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#cross-collateral-wallet-v2-user_data
+      def cross_collateral_wallet(**kwargs)
+        @session.sign_request(:get, '/sapi/v2/futures/loan/wallet', params: kwargs)
+      end
+
+      # Cross-Collateral Information (USER_DATA)
+      #
+      # GET /sapi/v2/futures/loan/configs
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [String] :loanCoin
+      # @option kwargs [String] :collateralCoin
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#cross-collateral-information-v2-user_data
+      def cross_collateral_info(**kwargs)
+        @session.sign_request(:get, '/sapi/v2/futures/loan/configs', params: kwargs)
+      end
+
+      # Calculate Rate After Adjust Cross-Collateral LTV (USER_DATA)
+      #
+      # GET /sapi/v2/futures/loan/calcAdjustLevel
+      #
+      # @param loanCoin [String]
+      # @param collateralCoin [String]
+      # @param amount [Float]
+      # @param direction [String] "ADDITIONAL", "REDUCED"
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#calculate-rate-after-adjust-cross-collateral-ltv-v2-user_data
+      def calculate_adjust_rate(loanCoin:, collateralCoin:, amount:, direction:, **kwargs)
+        Binance::Utils::Validation.require_param('loanCoin', loanCoin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+        Binance::Utils::Validation.require_param('amount', amount)
+        Binance::Utils::Validation.require_param('direction', direction)
+
+        @session.sign_request(:get, '/sapi/v2/futures/loan/calcAdjustLevel', params: kwargs.merge(
+          loanCoin: loanCoin,
+          collateralCoin: collateralCoin,
+          amount: amount,
+          direction: direction
+        ))
+      end
+
+      # Get Max Amount for Adjust Cross-Collateral LTV (USER_DATA)
+      #
+      # GET /sapi/v2/futures/loan/calcMaxAdjustAmount
+      #
+      # @param loanCoin [String]
+      # @param collateralCoin [String]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-max-amount-for-adjust-cross-collateral-ltv-v2-user_data
+      def calculate_adjust_max_amount(loanCoin:, collateralCoin:, **kwargs)
+        Binance::Utils::Validation.require_param('loanCoin', loanCoin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+
+        @session.sign_request(:get, '/sapi/v2/futures/loan/calcMaxAdjustAmount', params: kwargs.merge(
+          loanCoin: loanCoin,
+          collateralCoin: collateralCoin
+        ))
+      end
+
+      # Adjust Cross-Collateral LTV (TRADE)
+      #
+      # POST /sapi/v2/futures/loan/adjustCollateral
+      #
+      # @param loanCoin [String]
+      # @param collateralCoin [String]
+      # @param amount [Float]
+      # @param direction [String] "ADDITIONAL", "REDUCED"
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#adjust-cross-collateral-ltv-v2-trade
+      def adjust_cross_collateral(loanCoin:, collateralCoin:, amount:, direction:, **kwargs)
+        Binance::Utils::Validation.require_param('loanCoin', loanCoin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+        Binance::Utils::Validation.require_param('amount', amount)
+        Binance::Utils::Validation.require_param('direction', direction)
+
+        @session.sign_request(:post, '/sapi/v2/futures/loan/adjustCollateral', params: kwargs.merge(
+          loanCoin: loanCoin,
+          collateralCoin: collateralCoin,
+          amount: amount,
+          direction: direction
+        ))
+      end
+
+      # Adjust Cross-Collateral LTV History (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/adjustCollateral/history
+      #
+      # All data will be returned if loanCoin or collateralCoin is not sent
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [String] :loanCoin
+      # @option kwargs [String] :collateralCoin
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :limit default 500, max 1000
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#adjust-cross-collateral-ltv-history-user_data
+      def adjust_cross_collateral_history(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/futures/loan/adjustCollateral/history', params: kwargs)
+      end
+
+      # Cross-Collateral Liquidation History (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/liquidationHistory
+      #
+      # All data will be returned if loanCoin or collateralCoin is not sent
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [String] :loanCoin
+      # @option kwargs [String] :collateralCoin
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :limit default 500, max 1000
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#cross-collateral-liquidation-history-user_data
+      def cross_collateral_liquidation_history(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/futures/loan/liquidationHistory', params: kwargs)
+      end
+
+      # Check Collateral Repay Limit (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/collateralRepayLimit
+      #
+      # Check the maximum and minimum limit when repay with collateral.
+      #
+      # @param coin [String]
+      # @param collateralCoin [String]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#check-collateral-repay-limit-user_data
+      def collateral_repay_limit(coin:, collateralCoin:, **kwargs)
+        Binance::Utils::Validation.require_param('coin', coin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+
+        @session.sign_request(:get, '/sapi/v1/futures/loan/collateralRepayLimit', params: kwargs.merge(
+          coin: coin,
+          collateralCoin: collateralCoin
+        ))
+      end
+
+      # Get Collateral Repay Quote (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/collateralRepay
+      #
+      # Get quote before repay with collateral is mandatory, the quote will be valid within 25 seconds.
+      #
+      # @param coin [String]
+      # @param collateralCoin [String]
+      # @param amount [Float]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-collateral-repay-quote-user_data
+      def collateral_repay_quote(coin:, collateralCoin:, amount:, **kwargs)
+        Binance::Utils::Validation.require_param('coin', coin)
+        Binance::Utils::Validation.require_param('collateralCoin', collateralCoin)
+        Binance::Utils::Validation.require_param('amount', amount)
+
+        @session.sign_request(:get, '/sapi/v1/futures/loan/collateralRepay', params: kwargs.merge(
+          coin: coin,
+          collateralCoin: collateralCoin,
+          amount: amount
+        ))
+      end
+
+      # Repay with Collateral (USER_DATA)
+      #
+      # POST /sapi/v1/futures/loan/collateralRepay
+      #
+      # Repay with collateral. Get quote before repay with collateral is mandatory, the quote will be valid within 25 seconds.
+      #
+      # @param quoteId [String]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#repay-with-collateral-user_data
+      def repay_with_collateral(quoteId:, **kwargs)
+        Binance::Utils::Validation.require_param('quoteId', quoteId)
+
+        @session.sign_request(:post, '/sapi/v1/futures/loan/collateralRepay', params: kwargs.merge(
+          quoteId: quoteId
+        ))
+      end
+
+      # Collateral Repayment Result (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/collateralRepayResult
+      #
+      # Check collateral repayment result.
+      #
+      # @param quoteId [String]
+      # @param kwargs [Hash]
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#collateral-repayment-result-user_data
+      def repayment_result(quoteId:, **kwargs)
+        Binance::Utils::Validation.require_param('quoteId', quoteId)
+
+        @session.sign_request(:get, '/sapi/v1/futures/loan/collateralRepayResult', params: kwargs.merge(
+          quoteId: quoteId
+        ))
+      end
+
+      # Cross-Collateral Interest History (USER_DATA)
+      #
+      # GET /sapi/v1/futures/loan/interestHistory
+      #
+      # @param kwargs [Hash]
+      # @option kwargs [String] :collateralCoin
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :current Currently querying page. Start from 1. Default:1
+      # @option kwargs [Integer] :limit default 500, max 1000
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#cross-collateral-interest-history-user_data
+      def cross_collateral_interest_history(**kwargs)
+        @session.sign_request(:get, '/sapi/v1/futures/loan/interestHistory', params: kwargs)
+      end
+    end
+  end
+end

data/lib/binance/spot/loan.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Binance
+  class Spot
+    # all loan endpoints
+    # @see https://binance-docs.github.io/apidocs/spot/en/#crypto-loans-endpoints
+    module Loan
+      # Get Crypto Loans Income History (USER_DATA)
+      #
+      # GET /sapi/v1/loan/income
+      #
+      # @param asset [String]
+      # @option kwargs [String] :type
+      # @option kwargs [Integer] :startTime
+      # @option kwargs [Integer] :endTime
+      # @option kwargs [Integer] :limit default 20, max 100
+      # @option kwargs [Integer] :recvWindow The value cannot be greater than 60000
+      # @see https://binance-docs.github.io/apidocs/spot/en/#get-crypto-loans-income-history-user_data
+      def get_loan_history(asset:, **kwargs)
+        Binance::Utils::Validation.require_param('asset', asset)
+
+        @session.sign_request(:get, '/sapi/v1/loan/income', params: kwargs.merge(asset: asset))
+      end
+    end
+  end
+end