bybit-connector-ruby 0.1.1 → 0.1.3

data/lib/bybit/rest_api/earn_service.rb

@@ -1042,6 +1042,37 @@ module Bybit
         params = Bybit::Utils::WireKeys.camelize(params)
         @session.sign_request(method: :post, path: '/v5/earn/fixed-term/position/auto-invest', body: params)
       end
+
+      # Get Auto Savings Settings
+      #
+      # GET /v5/earn/flexible-saving/auto-savings
+      #
+      # @option kwargs [Array] :coins Coin names to query, for example `coins=BTC&coins=ETH`. Omit for all supported coins.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/earn/flexible-saving/auto-savings
+      def list_auto_savings(**kwargs)
+        coins = kwargs[:coins]
+        if coins.is_a?(Array) && coins.length > 50
+          raise Bybit::ConfigurationError,
+                'coins supports at most 50 values'
+        end
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/earn/flexible-saving/auto-savings', params: params)
+      end
+
+      # Edit Auto Savings Settings
+      #
+      # POST /v5/earn/flexible-saving/auto-savings
+      #
+      # @param is_selected [Boolean] Whether to enable auto savings
+      # @option kwargs [String] :coin Coin to change; omit or pass an empty string to change the global setting
+      # @option kwargs [Boolean] :purchase_immediately When enabling, asynchronously attempt to subscribe the available Funding Account balance; ignored when disabling
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/earn/flexible-saving/auto-savings
+      def edit_earn_auto_savings(is_selected:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(isSelected: is_selected))
+        @session.sign_request(method: :post, path: '/v5/earn/flexible-saving/auto-savings', body: params)
+      end
     end
   end
 end

data/lib/bybit/rest_api/event_service.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module Bybit
+  module RestApi
+    class EventService < BaseService
+      # Get Event Contract Order History
+      #
+      # GET /v5/event/order-list
+      #
+      # @option kwargs [String] :symbol Symbol name, e.g. `BTCUSDT-EC`
+      # @option kwargs [String] :order_id Order ID
+      # @option kwargs [String] :order_link_id User-defined order ID
+      # @option kwargs [Integer] :start_time Start time in milliseconds. Default: 7 days ago
+      # @option kwargs [Integer] :end_time End time in milliseconds. Default: now
+      # @option kwargs [Integer] :limit Number of items per page. Default: `50`, Range: [`1`, `100`]
+      # @option kwargs [String] :cursor Pagination cursor
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/event/trade/order-list
+      def get_ec_order_history(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/event/order-list', params: params)
+      end
+
+      # Get Event Contract Active Orders
+      #
+      # GET /v5/event/order-realtime
+      #
+      # @option kwargs [String] :symbol Symbol name, e.g. `BTCUSDT-EC`
+      # @option kwargs [String] :order_id Order ID. If both `orderId` and `orderLinkId` are passed, `orderId` takes priority
+      # @option kwargs [String] :order_link_id User-defined order ID
+      # @option kwargs [Integer] :limit Number of items per page. Default: `20`, Range: [`1`, `50`]
+      # @option kwargs [String] :cursor Pagination cursor. Use `nextPageCursor` from the response to retrieve the next page
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/event/trade/open-order
+      def get_ec_active_orders(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/event/order-realtime', params: params)
+      end
+
+      # Get Event Contract Position Info
+      #
+      # GET /v5/event/positions
+      #
+      # @option kwargs [String] :symbol Symbol name, e.g. `BTCUSDT-EC`. If not passed, returns all EC positions
+      # @option kwargs [String] :base_coin Base coin filter, e.g. `BTC`
+      # @option kwargs [String] :settle_coin Settle coin filter, e.g. `USDT`
+      # @option kwargs [Integer] :limit Number of items per page. Default: `20`, Range: [`1`, `50`]
+      # @option kwargs [String] :cursor Pagination cursor. Use `nextPageCursor` from the response to retrieve the next page
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/event/trade/position
+      def get_ec_position_info(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/event/positions', params: params)
+      end
+
+      # Get Event Contract Settlement Records
+      #
+      # GET /v5/event/settlements
+      #
+      # @param symbol [String] Symbol name, e.g. `BTCUSDT-EC`
+      # @option kwargs [String] :order_id Order ID filter
+      # @option kwargs [Integer] :start_time Start time in milliseconds. Default: 7 days ago
+      # @option kwargs [Integer] :end_time End time in milliseconds. Default: now
+      # @option kwargs [Integer] :limit Number of items per page. Default: `50`, Range: [`1`, `100`]
+      # @option kwargs [String] :cursor Pagination cursor
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/event/trade/settlement
+      def get_ec_settlements(symbol:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(symbol: symbol))
+        @session.sign_request(method: :get, path: '/v5/event/settlements', params: params)
+      end
+
+      # Get Event Contract Trade History
+      #
+      # GET /v5/event/trades
+      #
+      # @param symbol [String] Symbol name, e.g. `BTCUSDT-EC`
+      # @option kwargs [String] :order_id Order ID filter
+      # @option kwargs [String] :order_link_id User-defined order ID
+      # @option kwargs [Integer] :start_time Start time in milliseconds. Default: 7 days ago
+      # @option kwargs [Integer] :end_time End time in milliseconds. Default: now
+      # @option kwargs [Integer] :limit Number of items per page. Default: `50`, Range: [`1`, `100`]
+      # @option kwargs [String] :cursor Pagination cursor
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/event/trade/execution
+      def get_ec_trade_history(symbol:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(symbol: symbol))
+        @session.sign_request(method: :get, path: '/v5/event/trades', params: params)
+      end
+    end
+  end
+end

data/lib/bybit/rest_api/fiat_service.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Bybit
+  module RestApi
+    class FiatService < BaseService
+      # Query Account Balance
+      #
+      # GET /v5/fiat/balance-query
+      #
+      # @option kwargs [String] :account_category Account type (reserved field)
+      # @option kwargs [String] :currency Currency code:
+      #   - Fiat: ISO 4217 standard code, e.g., EUR, GEL, KZT
+      #   - Crypto: e.g., USDT, BTC, ETH
+      #   - Omit to query all balances
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/balance-query
+      def query_balance(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/fiat/balance-query', params: params)
+      end
+
+      # Get Trading Pairs
+      #
+      # GET /v5/fiat/query-coin-list
+      #
+      # @option kwargs [Integer] :side Trading direction:
+      #   - `0`: buy - Buy crypto, sell fiat
+      #   - `1`: sell - Sell crypto, buy fiat
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/query-coin-list
+      def query_coin_list(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/fiat/query-coin-list', params: params)
+      end
+
+      # Query Trade History
+      #
+      # GET /v5/fiat/query-trade-history
+      #
+      # @option kwargs [Integer] :index Page number, starts from 1
+      # @option kwargs [Integer] :limit Page size, maximum 100
+      # @option kwargs [String] :start_time Query start time (millisecond timestamp)
+      # @option kwargs [String] :end_time Query end time (millisecond timestamp)
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/query-trade-history
+      def query_trade_history(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/fiat/query-trade-history', params: params)
+      end
+
+      # Request a Quote
+      #
+      # POST /v5/fiat/quote-apply
+      #
+      # @param from_coin [String] Convert from coin (coin to sell)
+      # @param from_coin_type [String] From coin type
+      # @param to_coin [String] Convert to coin (coin to buy)
+      # @param to_coin_type [String] To coin type
+      # @param request_amount [String] Request coin amount (the amount you want to sell)
+      # @option kwargs [String] :request_coin_type Coin type you want to sell, defaults to fiat
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/quote-apply
+      def apply_quote(from_coin:, from_coin_type:, to_coin:, to_coin_type:, request_amount:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(fromCoin: from_coin, fromCoinType: from_coin_type, toCoin: to_coin, toCoinType: to_coin_type, requestAmount: request_amount))
+        @session.sign_request(method: :post, path: '/v5/fiat/quote-apply', body: params)
+      end
+
+      # Get Reference Price
+      #
+      # GET /v5/fiat/reference-price
+      #
+      # @param symbol [String] Coin pair, format: "FIAT-CRYPTO", e.g., "EUR-USDT"
+      # @option kwargs [String] :payment_method Payment method (reserved field)
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/reference-price
+      def get_reference_price(symbol:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(symbol: symbol))
+        @session.sign_request(method: :get, path: '/v5/fiat/reference-price', params: params)
+      end
+
+      # Confirm Quote and Execute Trade
+      #
+      # POST /v5/fiat/trade-execute
+      #
+      # @param quote_tx_id [String] Quote transaction ID from the quote request
+      # @param sub_user_id [String] The user's sub userId in Bybit
+      # @option kwargs [String] :webhook_url Optional webhook URL to receive trade status notifications (max 256 characters)
+      # @option kwargs [String] :merchant_request_id Customised request ID (max 36 characters). Generally it is useless, but convenient for internal tracking
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/confirm-quote
+      def confirm_quote(quote_tx_id:, sub_user_id:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(quoteTxId: quote_tx_id, subUserId: sub_user_id))
+        @session.sign_request(method: :post, path: '/v5/fiat/trade-execute', body: params)
+      end
+
+      # Query Trade Status
+      #
+      # GET /v5/fiat/trade-query
+      #
+      # @option kwargs [String] :trade_no Trade order number (either tradeNo or merchantRequestId must be provided)
+      # @option kwargs [String] :merchant_request_id Merchant request ID (either tradeNo or merchantRequestId must be provided)
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/asset/fiat-convert/query-trade
+      def query_trade(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/fiat/trade-query', params: params)
+      end
+    end
+  end
+end

data/lib/bybit/rest_api/institutional_loan_service.rb

@@ -95,12 +95,34 @@ module Bybit
       # @param order_id [String] Loan order ID to repay
       # @param amount [String] Repayment amount
       # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
-      # @see https://bybit-exchange.github.io/docs/v5/otc/repay-loan
+      # @see https://bybit-exchange.github.io/docs/v5/otc/repay
       def repay_loan(order_id:, amount:, **kwargs)
         params = kwargs.merge(order_id: order_id, amount: amount)
         params = Bybit::Utils::WireKeys.camelize(params)
         @session.sign_request(method: :post, path: '/v5/ins-loan/repay-loan', body: params)
       end
+
+      # Get Coin Delta Amount
+      #
+      # GET /v5/ins-loan/coin-delta-amount
+      #
+      # @option kwargs [String] :coin Coin name to filter, uppercase only. e.g. `BTC`. If not passed, returns all coins.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/otc/coin-delta-amount
+      def ins_loan_coin_delta_amount(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/ins-loan/coin-delta-amount', params: params)
+      end
+
+      # Get Delay Liquidation Status
+      #
+      # GET /v5/ins-loan/delay-liq-status
+      #
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/otc/delay-liq-status
+      def ins_loan_delay_liq_status
+        @session.sign_request(method: :get, path: '/v5/ins-loan/delay-liq-status')
+      end
     end
   end
 end

data/lib/bybit/rest_api/market_service.rb

@@ -350,6 +350,23 @@ module Bybit
         params = Bybit::Utils::WireKeys.camelize(params)
         @session.public_request(path: '/v5/market/tickers', params: params)
       end
+
+      # Get Option Base Coins
+      #
+      # GET /v5/market/option-base-coins
+      #
+      # @option kwargs [String] :underlying_type Underlying asset type. Supports comma-separated values, e.g. `0,2`.
+      #   - `0`: Crypto
+      #   - `1`: Commodity
+      #   - `2`: Stock
+      #   - `3`: Forex
+      #   - `4`: Oil
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/market/option-base-coins
+      def get_option_base_coins(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.public_request(path: '/v5/market/option-base-coins', params: params)
+      end
     end
   end
 end

data/lib/bybit/rest_api/position_service.rb

@@ -197,6 +197,21 @@ module Bybit
         params = Bybit::Utils::WireKeys.camelize(params)
         @session.sign_request(method: :post, path: '/v5/position/switch-mode', body: params)
       end
+
+      # Get Futures Leverage
+      #
+      # GET /v5/position/symbol-info
+      #
+      # @param category [String] Product type:
+      #   - `linear`: USDT perpetual, USDC contract
+      #   - `inverse`: Inverse perpetual, Inverse futures
+      # @option kwargs [String] :symbol Symbol name, e.g. `BTCUSDT`, uppercase only
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/position/batch-lvg
+      def get_symbol_info(category:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(category: category))
+        @session.sign_request(method: :get, path: '/v5/position/symbol-info', params: params)
+      end
     end
   end
 end

data/lib/bybit/rest_api/referral_service.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Bybit
+  module RestApi
+    class ReferralService < BaseService
+      # Get referral rules and campaign task rewards for the current site
+      #
+      # POST /v5/referral/campaign/rewards
+      #
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/referral/referral-campaign-rewards
+      def get_campaign_rewards
+        @session.sign_request(method: :post, path: '/v5/referral/campaign/rewards')
+      end
+
+      # Get Referral Commission Records
+      #
+      # POST /v5/referral/commission/records
+      #
+      # @option kwargs [Array] :user_id_list Invitee ID list; an empty list does not filter by invitee.
+      # @option kwargs [String] :start_time Query start time in YYYY-MM-DD HH:mm:ss format; an invalid value is passed downstream as an empty string, whose handling is unverified.
+      # @option kwargs [String] :end_time Query end time in YYYY-MM-DD HH:mm:ss format; an invalid value is passed downstream as an empty string, whose handling is unverified.
+      # @option kwargs [Integer] :page One-based page number; 0 is treated as 1.
+      # @option kwargs [Integer] :page_size Number of records per page; 0 or a value greater than 200 is treated as 10.
+      # @option kwargs [Integer] :product_line Product lines: 0=unknown; 1=spot; 2=contracts; 3=options; 4=USDC perpetual; 6=TradeFi; 9=Alpha. Unrecognized downstream product lines map to 0.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/referral/referral-commission-records
+      def get_commission_records(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :post, path: '/v5/referral/commission/records', body: params)
+      end
+
+      # Get Referral User Identity Profile
+      #
+      # POST /v5/referral/user/identity-profile
+      #
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/referral/referral-user-identity-profile
+      def get_user_identity_profile
+        @session.sign_request(method: :post, path: '/v5/referral/user/identity-profile')
+      end
+
+      # Get referral user invitations
+      #
+      # POST /v5/referral/user/invitations
+      #
+      # @option kwargs [Array] :user_id_list
+      # @option kwargs [String] :start_time Recommended format: YYYY-MM-DD HH:mm:ss; invalid or empty values are passed downstream as 0.
+      # @option kwargs [String] :end_time Recommended format: YYYY-MM-DD HH:mm:ss; invalid or empty values are passed downstream as 0.
+      # @option kwargs [Integer] :page
+      # @option kwargs [Integer] :page_size Values 0 and greater than 200 are reset to 10 by the current service implementation.
+      # @option kwargs [Integer] :friend_status
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/referral/referral-user-invitations
+      def get_user_invitations(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :post, path: '/v5/referral/user/invitations', body: params)
+      end
+    end
+  end
+end

data/lib/bybit/rest_api/spot_margin_service.rb

@@ -57,6 +57,264 @@ module Bybit
         params = Bybit::Utils::WireKeys.camelize(params)
         @session.public_request(path: '/v5/spot-margin-trade/data', params: params)
       end
+
+      # Get Spot Margin Coin State
+      #
+      # GET /v5/spot-margin-trade/coinstate
+      #
+      # @option kwargs [String] :currency Coin name, uppercase only. e.g. `BTC`. If not passed, returns all coin states.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/coinstate
+      def get_trade_coin_state(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/coinstate', params: params)
+      end
+
+      # Query Fixed-Rate Available Inventory
+      #
+      # GET /v5/spot-margin-trade/fixed-available-inventory
+      #
+      # @param currency [String] Borrow coin name, uppercase only. e.g. `USDT`, `BTC`. **Required.**
+      # @param term [String] Loan term in days. e.g. `7`, `14`, `30`, `90`, `180`. **Required.**
+      # @param annual_rate [String] Annual interest rate. e.g. `0.02` means 2%. **Required.**
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixed-available-inventory
+      def query_fixed_available_inventory(currency:, term:, annual_rate:)
+        params = Bybit::Utils::WireKeys.camelize({ currency: currency, term: term, annualRate: annual_rate })
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/fixed-available-inventory', params: params)
+      end
+
+      # Fixed-Rate Borrow
+      #
+      # POST /v5/spot-margin-trade/fixedborrow
+      #
+      # @param order_currency [String] Borrow coin name, uppercase only. e.g. `USDT`, `BTC`.
+      # @param order_amount [String] Borrow amount.
+      # @param annual_rate [String] Annual interest rate. e.g. `0.02` means 2%.
+      # @param term [String] Loan term in days. Supported values: `7`, `14`, `30`, `90`, `180`.
+      # @option kwargs [String] :repay_type Maturity handling type.
+      #   - `1`: Auto-repay at maturity (default)
+      #   - `2`: Convert to flexible-rate (variable-rate) loan at maturity
+      # @option kwargs [String] :strategy_type Order strategy.
+      #   - `PARTIAL`: Partial fill or cancel (immediate-or-cancel)
+      #   - `FULL`: Fill or kill (all-or-nothing)
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow
+      def account_fixed_borrow(order_currency:, order_amount:, annual_rate:, term:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(orderCurrency: order_currency, orderAmount: order_amount, annualRate: annual_rate, term: term))
+        @session.sign_request(method: :post, path: '/v5/spot-margin-trade/fixedborrow', body: params)
+      end
+
+      # Query Fixed-Rate Borrow Contracts
+      #
+      # GET /v5/spot-margin-trade/fixedborrow-contract-info
+      #
+      # @option kwargs [String] :order_id Filter by borrow order ID.
+      # @option kwargs [String] :order_currency Filter by borrow coin name, uppercase only. e.g. `USDT`.
+      # @option kwargs [String] :term Filter by loan term in days. e.g. `7`, `14`, `30`, `90`, `180`.
+      # @option kwargs [String] :limit Page size. Range: [1, 100]. Default: `10`.
+      # @option kwargs [String] :cursor Cursor for pagination. Use `nextPageCursor` from previous response.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow-contract-info
+      def query_fixed_borrow_contracts(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/fixedborrow-contract-info', params: params)
+      end
+
+      # Query Fixed-Rate Borrow Orders
+      #
+      # GET /v5/spot-margin-trade/fixedborrow-order-info
+      #
+      # @option kwargs [String] :order_id Filter by borrow order ID.
+      # @option kwargs [String] :order_currency Filter by borrow coin name, uppercase only. e.g. `USDT`.
+      # @option kwargs [String] :state Filter by order state.
+      #   - `1`: Matching (order accepted, matching in progress)
+      #   - `2`: Partially filled & cancelled
+      #   - `3`: Fully filled
+      #   - `4`: Cancelled
+      # @option kwargs [String] :term Filter by loan term in days. e.g. `7`, `14`, `30`, `90`, `180`.
+      # @option kwargs [String] :limit Page size. Range: [1, 100]. Default: `10`.
+      # @option kwargs [String] :cursor Cursor for pagination. Use `nextPageCursor` from previous response.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow-order-info
+      def query_fixed_borrow_orders(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/fixedborrow-order-info', params: params)
+      end
+
+      # Query Fixed-Rate Borrow Market
+      #
+      # GET /v5/spot-margin-trade/fixedborrow-order-quote
+      #
+      # @param order_currency [String] Borrow coin name, uppercase only. e.g. `USDT`, `BTC`. **Required.**
+      # @option kwargs [String] :order_by Sort field.
+      #   - `apy`: Sort by annual interest rate
+      #   - `term`: Sort by loan term
+      #   - `quantity`: Sort by available quantity
+      # @option kwargs [String] :term Filter by loan term in days. e.g. `7`, `14`, `30`, `90`, `180`.
+      # @option kwargs [Integer] :sort Sort order.
+      #   - `0`: Ascending (default)
+      #   - `1`: Descending
+      # @option kwargs [Integer] :limit Page size. Range: [1, 100]. Default: `10`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow-order-quote
+      def query_fixed_borrow_market(order_currency:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(order_currency: order_currency))
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/fixedborrow-order-quote', params: params)
+      end
+
+      # Renew Fixed-Rate Borrow
+      #
+      # POST /v5/spot-margin-trade/fixedborrow-renew
+      #
+      # @param loan_id [String] The loan contract ID (corresponds to match order ID). Required.
+      # @option kwargs [String] :qty Renewal amount.
+      #   - If not provided, the full prepayment amount of the contract is used
+      #   - Must be greater than 0
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow-renew
+      def renew_fixed_borrow(loan_id:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(loanId: loan_id))
+        @session.sign_request(method: :post, path: '/v5/spot-margin-trade/fixedborrow-renew', body: params)
+      end
+
+      # Get Flexible Available Inventory
+      #
+      # GET /v5/spot-margin-trade/flexible-available-inventory
+      #
+      # @param currency [String] Coin name, uppercase only. e.g. `BTC`
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/flexible-available-inventory
+      def get_trade_flexible_available_inventory(currency:)
+        params = Bybit::Utils::WireKeys.camelize({ currency: currency })
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/flexible-available-inventory', params: params)
+      end
+
+      # Get Auto Repay Mode
+      #
+      # GET /v5/spot-margin-trade/get-auto-repay-mode
+      #
+      # @option kwargs [String] :currency Coin name, uppercase only. e.g. `ETH`. When omitted, returns settings for all currencies.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/get-auto-repay-mode
+      def get_trade_auto_repay_mode(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/get-auto-repay-mode', params: params)
+      end
+
+      # Query Borrow Liability
+      #
+      # GET /v5/spot-margin-trade/liability
+      #
+      # @param currency [String] Coin name, uppercase only. e.g. `USDT`, `BTC`. **Required.**
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/liability
+      def query_borrow_liability(currency:)
+        params = Bybit::Utils::WireKeys.camelize({ currency: currency })
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/liability', params: params)
+      end
+
+      # Get Max Borrowable Amount
+      #
+      # GET /v5/spot-margin-trade/max-borrowable
+      #
+      # @param currency [String] Coin name, uppercase only. e.g. `BTC`
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/max-borrowable
+      def get_trade_max_borrowable(currency:)
+        params = Bybit::Utils::WireKeys.camelize({ currency: currency })
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/max-borrowable', params: params)
+      end
+
+      # Get Repayment Available Amount
+      #
+      # GET /v5/spot-margin-trade/repayment-available-amount
+      #
+      # @param currency [String] Coin name, uppercase only. e.g. `BTC`
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/repayment-available-amount
+      def get_trade_repayment_available_amount(currency:)
+        params = Bybit::Utils::WireKeys.camelize({ currency: currency })
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/repayment-available-amount', params: params)
+      end
+
+      # Set Auto Repay Mode
+      #
+      # POST /v5/spot-margin-trade/set-auto-repay-mode
+      #
+      # @param auto_repay_mode [String] Auto repay mode switch:
+      #   - `1`: Enable auto repay — Enable auto repay
+      #   - `0`: Disable auto repay — Disable auto repay
+      # @option kwargs [String] :currency Coin name, uppercase only (e.g. `USDT`, `ETH`).
+      #   If omitted, auto-repay is enabled/disabled for **all** currencies.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/set-auto-repay-mode
+      def set_auto_repay_mode(auto_repay_mode:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(autoRepayMode: auto_repay_mode))
+        @session.sign_request(method: :post, path: '/v5/spot-margin-trade/set-auto-repay-mode', body: params)
+      end
+
+      # Set spot cross margin leverage
+      #
+      # POST /v5/spot-margin-trade/set-leverage
+      #
+      # @param leverage [String] Leverage amount, valid range is 2 to 10
+      # @option kwargs [String] :currency Coin name, uppercase only (optional)
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/set-leverage
+      def spot_margin_set_leverage(leverage:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(leverage: leverage))
+        @session.sign_request(method: :post, path: '/v5/spot-margin-trade/set-leverage', body: params)
+      end
+
+      # Get Spot Margin Trade Status
+      #
+      # GET /v5/spot-margin-trade/state
+      #
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/status
+      def get_trade_state
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/state')
+      end
+
+      # Toggle spot cross margin mode
+      #
+      # POST /v5/spot-margin-trade/switch-mode
+      #
+      # @param spot_margin_mode [String] Spot margin mode: 1=on, 0=off
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/switch-mode
+      def spot_margin_switch_mode(spot_margin_mode:)
+        params = Bybit::Utils::WireKeys.camelize({ spotMarginMode: spot_margin_mode })
+        @session.sign_request(method: :post, path: '/v5/spot-margin-trade/switch-mode', body: params)
+      end
+
+      # Query Fixed-Rate Borrow Penalty Interest
+      #
+      # GET /v5/spot-margin-trade/fixedborrow-interest-accrued
+      #
+      # @option kwargs [String] :order_id Filter by fixed-rate borrow order ID.
+      # @option kwargs [String] :order_currency Filter by a single borrow coin, such as `USDT`.
+      # @option kwargs [String] :limit Page size as a string, from 1 to 100; defaults to 10.
+      # @option kwargs [String] :cursor Opaque `nextPageCursor` returned by the previous page.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow-interest-accrued
+      def query_fixed_borrow_penalty_interest(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/spot-margin-trade/fixedborrow-interest-accrued', params: params)
+      end
+
+      # Cancel Fixed-Rate Borrow Order
+      #
+      # POST /v5/spot-margin-trade/fixedborrow-order-cancel
+      #
+      # @param order_id [String] Fixed-rate borrow order ID, not the contract match ID.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/spot-margin-uta/fixedborrow-order-cancel
+      def cancel_fixed_borrow_order(order_id:)
+        params = Bybit::Utils::WireKeys.camelize({ orderId: order_id })
+        @session.sign_request(method: :post, path: '/v5/spot-margin-trade/fixedborrow-order-cancel', body: params)
+      end
     end
   end
 end