bybit-connector-ruby 0.1.0 → 0.1.3

data/lib/bybit/rest_api/pre_upgrade_service.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+module Bybit
+  module RestApi
+    # /v5/pre-upgrade/* — historical queries scoped to activity that occurred
+    # BEFORE a Classic → UTA account upgrade. These records live in the legacy
+    # partition and never merge into the UTA tables, so callers upgrading from
+    # older SDKs need a dedicated namespace to fetch them.
+    class PreUpgradeService < BaseService
+      # Get Pre-upgrade Order History
+      #
+      # GET /v5/pre-upgrade/order/history
+      #
+      # @param category [String] Product type: `linear`, `inverse`, `option`
+      # @option kwargs [String] :symbol Symbol filter
+      # @option kwargs [String] :base_coin Base coin filter
+      # @option kwargs [String] :order_id Order ID filter
+      # @option kwargs [String] :order_link_id User-side order link ID
+      # @option kwargs [String] :order_filter Order-type filter
+      # @option kwargs [String] :order_status Order status filter
+      # @option kwargs [Integer] :start_time Start ms timestamp
+      # @option kwargs [Integer] :end_time End ms timestamp
+      # @option kwargs [Integer] :limit Records per page
+      # @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/pre-upgrade/order-list
+      def get_order_history(category:, **kwargs)
+        params = kwargs.merge(category: category)
+        params = Bybit::Utils::WireKeys.camelize(params)
+        @session.sign_request(method: :get, path: '/v5/pre-upgrade/order/history', params: params)
+      end
+
+      # Get Pre-upgrade Trade (Execution) History
+      #
+      # GET /v5/pre-upgrade/execution/list
+      #
+      # @param category [String] Product type: `linear`, `inverse`, `option`
+      # @option kwargs [String] :symbol Symbol filter
+      # @option kwargs [String] :order_id Order ID filter
+      # @option kwargs [String] :order_link_id User-side order link ID
+      # @option kwargs [String] :base_coin Base coin filter
+      # @option kwargs [Integer] :start_time Start ms timestamp
+      # @option kwargs [Integer] :end_time End ms timestamp
+      # @option kwargs [String] :exec_type Execution type filter
+      # @option kwargs [Integer] :limit Records per page
+      # @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/pre-upgrade/execution
+      def get_trade_history(category:, **kwargs)
+        params = kwargs.merge(category: category)
+        params = Bybit::Utils::WireKeys.camelize(params)
+        @session.sign_request(method: :get, path: '/v5/pre-upgrade/execution/list', params: params)
+      end
+
+      # Get Pre-upgrade Closed PnL
+      #
+      # GET /v5/pre-upgrade/position/closed-pnl
+      #
+      # Bybit V5 only requires `symbol` when `category` is `inverse`; for
+      # `linear` it's optional. Keep it as an optional kwarg here — callers
+      # querying inverse pass it, callers on linear can omit it.
+      #
+      # @param category [String] Product type: `linear`, `inverse`
+      # @option kwargs [String] :symbol Symbol name (required for `inverse`)
+      # @option kwargs [Integer] :start_time Start ms timestamp
+      # @option kwargs [Integer] :end_time End ms timestamp
+      # @option kwargs [Integer] :limit Records per page
+      # @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/pre-upgrade/close-pnl
+      def get_closed_pnl(category:, **kwargs)
+        params = kwargs.merge(category: category)
+        params = Bybit::Utils::WireKeys.camelize(params)
+        @session.sign_request(method: :get, path: '/v5/pre-upgrade/position/closed-pnl', params: params)
+      end
+
+      # Get Pre-upgrade Transaction Log (USDC Derivatives wallet)
+      #
+      # GET /v5/pre-upgrade/account/transaction-log
+      #
+      # @param category [String] Product type: `linear`, `option`
+      # @option kwargs [String] :base_coin Base coin filter
+      # @option kwargs [String] :type Transaction type filter
+      # @option kwargs [Integer] :start_time Start ms timestamp
+      # @option kwargs [Integer] :end_time End ms timestamp
+      # @option kwargs [Integer] :limit Records per page
+      # @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/pre-upgrade/transaction-log
+      def get_transaction_log(category:, **kwargs)
+        params = kwargs.merge(category: category)
+        params = Bybit::Utils::WireKeys.camelize(params)
+        @session.sign_request(method: :get, path: '/v5/pre-upgrade/account/transaction-log', params: params)
+      end
+
+      # Get Pre-upgrade Option Delivery Record
+      #
+      # GET /v5/pre-upgrade/asset/delivery-record
+      #
+      # @param category [String] Product type: `option`
+      # @option kwargs [String] :symbol Symbol filter
+      # @option kwargs [Integer] :expiry_date Delivery expiry date (YYYYMMDD)
+      # @option kwargs [Integer] :limit Records per page
+      # @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/pre-upgrade/delivery
+      def get_option_delivery_record(category:, **kwargs)
+        params = kwargs.merge(category: category)
+        params = Bybit::Utils::WireKeys.camelize(params)
+        @session.sign_request(method: :get, path: '/v5/pre-upgrade/asset/delivery-record', params: params)
+      end
+
+      # Get Pre-upgrade USDC Session Settlement Record
+      #
+      # GET /v5/pre-upgrade/asset/settlement-record
+      #
+      # @param category [String] Product type: `linear`
+      # @option kwargs [String] :symbol Symbol filter
+      # @option kwargs [Integer] :limit Records per page
+      # @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/pre-upgrade/settlement
+      def get_usdc_session_settlement(category:, **kwargs)
+        params = kwargs.merge(category: category)
+        params = Bybit::Utils::WireKeys.camelize(params)
+        @session.sign_request(method: :get, path: '/v5/pre-upgrade/asset/settlement-record', 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

data/lib/bybit/rest_api/spot_x_service.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+module Bybit
+  module RestApi
+    class SpotXService < BaseService
+      # Get Launchpool project (activity) list
+      #
+      # GET /v5/spot-x/launchpool/project/list
+      #
+      # @param status [Integer] Activity phase filter.
+      #   - `0` — Upcoming
+      #   - `1` — Ongoing
+      #   - `2` — Ended
+      # @option kwargs [String] :activity_coin Filter by activity (reward) coin symbol (case-insensitive), e.g. `BTC`, `ETH`.
+      # @option kwargs [String] :project_id Exact activity code. Use to query a single project.
+      # @option kwargs [String] :cursor Pagination cursor returned as `nextPageCursor` in the previous response. Omit for the first page.
+      # @option kwargs [Integer] :limit Number of items per page. Defaults to `10`. Maximum `10`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/launchpool/launchpool-project-list
+      def get_launchpool_project_list(status:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(status: status))
+        @session.public_request(path: '/v5/spot-x/launchpool/project/list', params: params)
+      end
+
+      # Get user's staking operation records
+      #
+      # POST /v5/spot-x/launchpool/user/activity-log
+      #
+      # @option kwargs [String] :stake_coin Filter by stake coin symbol (case-sensitive).
+      # @option kwargs [Integer] :type Filter by operation type. Omit to return all types.
+      #   - `0` PLEDGE — manual stake-in
+      #   - `1` REDEEM — manual redeem
+      #   - `2` INTEREST — reward/interest credit
+      #   - `3` AUTO_REDEEM — auto principal return on maturity
+      #   - `4` LOAN_PLEDGE — leveraged stake-in
+      #   - `5` LOAN_REDEEM — manual leveraged redeem
+      #   - `6` LOAN_AUTO_REDEEM — auto leveraged maturity redemption
+      #   - `7` LOAN_RISKRATE_AUTO_REDEEM — leveraged liquidation
+      #   - `8` RISK_USER_AUTO_REDEEM — risk-control forced redeem (non-leveraged)
+      #   - `9` LOAN_RISK_USER_AUTO_REDEEM — risk-control forced redeem (leveraged)
+      #   - `10` EARN_REWARD — earn product reward credit
+      # @option kwargs [Integer] :status Filter by record status. Omit to return all statuses.
+      #   - `0` — Pending
+      #   - `1` — Success
+      #   - `2` — Failed
+      # @option kwargs [String] :start_time Query start time — 13-digit Unix millisecond timestamp string.
+      #   Must be provided together with `endTime`.
+      # @option kwargs [String] :end_time Query end time — 13-digit Unix millisecond timestamp string.
+      #   Must be provided together with `startTime`.
+      # @option kwargs [Integer] :page_size Number of records per page. Defaults to `10`. Maximum `10`.
+      # @option kwargs [Integer] :current Page number (1-based). Defaults to `1`. Maximum `100`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/launchpool/launchpool-activity-log
+      def get_launchpool_user_activity_log(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :post, path: '/v5/spot-x/launchpool/user/activity-log', body: params)
+      end
+
+      # Get user's active staking positions
+      #
+      # GET /v5/spot-x/launchpool/user/current-staking
+      #
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/launchpool/launchpool-current-staking
+      def get_launchpool_user_current_staking
+        @session.sign_request(method: :get, path: '/v5/spot-x/launchpool/user/current-staking')
+      end
+
+      # Get user's completed staking position history
+      #
+      # POST /v5/spot-x/launchpool/user/history
+      #
+      # @option kwargs [String] :stake_coin Filter by stake coin symbol.
+      # @option kwargs [String] :reward_coin Filter by reward coin symbol.
+      # @option kwargs [String] :start_time Staking period start filter — 13-digit Unix millisecond timestamp string.
+      #   Filters positions whose `stakeBeginTime` is on or after this value.
+      #   Must be provided together with `endTime`.
+      # @option kwargs [String] :end_time Staking period end filter — 13-digit Unix millisecond timestamp string.
+      #   Filters positions whose `stakeEndTime` is on or before this value.
+      #   Must be provided together with `startTime`.
+      # @option kwargs [Integer] :page_size Number of records per page. Defaults to `10`. Maximum `10`.
+      # @option kwargs [Integer] :current Page number (1-based). Defaults to `1`. Maximum `100`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/launchpool/launchpool-user-history
+      def get_launchpool_user_history(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :post, path: '/v5/spot-x/launchpool/user/history', body: params)
+      end
+
+      # Get Puzzle project (activity) list
+      #
+      # GET /v5/spot-x/puzzle/project/list
+      #
+      # @param status [Integer] Activity phase filter.
+      #   - `0` — Upcoming (not yet started)
+      #   - `1` — Ongoing (in progress)
+      #   - `2` — Ended
+      # @option kwargs [String] :project_id Exact activity code (unique project identifier). Use to query a single project.
+      # @option kwargs [String] :activity_coin Filter by activity coin symbol (case-insensitive), e.g. `BTC`, `ETH`.
+      # @option kwargs [String] :cursor Pagination cursor returned as `nextPageCursor` in the previous response. Omit for the first page.
+      # @option kwargs [Integer] :limit Number of items per page. Defaults to `10`. Maximum `10`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/puzzle/puzzle-project-list
+      def get_puzzle_project_list(status:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(status: status))
+        @session.public_request(path: '/v5/spot-x/puzzle/project/list', params: params)
+      end
+
+      # Get Token Splash project (activity) list
+      #
+      # GET /v5/spot-x/token-splash/project/list
+      #
+      # @param status [Integer] Activity phase filter.
+      #   - `0` — Upcoming (registration not yet started)
+      #   - `1` — Ongoing (activity in progress)
+      #   - `2` — Ended (announcement time has passed)
+      # @option kwargs [String] :project_id Exact activity code. Use to query a single project.
+      # @option kwargs [String] :activity_coin Filter by activity coin symbol (case-insensitive), e.g. `BTC`, `ETH`.
+      # @option kwargs [String] :cursor Pagination cursor returned as `nextPageCursor` in the previous response. Omit for the first page.
+      # @option kwargs [Integer] :limit Number of items per page. Defaults to `10`. Maximum `10`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/token-splash/token-splash-project-list
+      def get_token_splash_project_list(status:, **kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs.merge(status: status))
+        @session.public_request(path: '/v5/spot-x/token-splash/project/list', params: params)
+      end
+
+      # Get user's Token Splash trade-task progress
+      #
+      # GET /v5/spot-x/token-splash/user/activity-params
+      #
+      # @option kwargs [String] :project_id Filter by exact activity code. Returns data for a single project when provided.
+      # @option kwargs [String] :activity_coin Filter by activity coin symbol (case-insensitive), e.g. `BTC`, `ETH`.
+      # @return [Hash] Bybit V5 ApiResponse envelope (retCode / retMsg / result / retExtInfo / time).
+      # @see https://bybit-exchange.github.io/docs/v5/finance/spot-x/token-splash/token-splash-user-activity-params
+      def get_token_splash_user_activity_params(**kwargs)
+        params = Bybit::Utils::WireKeys.camelize(kwargs)
+        @session.sign_request(method: :get, path: '/v5/spot-x/token-splash/user/activity-params', params: params)
+      end
+    end
+  end
+end