bybit-connector-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2e337e2d3927cdb53b707d0bfd441323cb293a43e2c3ded843d273c47f439af5
+  data.tar.gz: c4dfa85d62da8da24fc1cccdc5101631404182a3910de24f65f899ed972771dd
+SHA512:
+  metadata.gz: 9bad03bebb0cc8d633b4f014d42da79b592ade8d8f90b77a4a9ed239a0d46ae094aa8ba236a01616abb5b0b7596a85627cccad53ebce950334c544eef3ff0570
+  data.tar.gz: 310c666e1c0b387b84d91ab4fff0f78f401224eb09f74724bd64e021c4bf5fc1ff4f3458e383ed7a040bba69528602bedbb48f2da8b3d54cf1af30a142fa3f42

data/CHANGELOG.md

@@ -0,0 +1,259 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.1.0 — 2026-07-20
+
+### Added
+- `AccountService#batch_set_collateral(...)`
+- `AccountService#get_info(...)`
+- `AccountService#get_wallet_balance(...)`
+- `AccountService#get_instruments(...)`
+- `AccountService#get_borrow_history(...)`
+- `AccountService#get_collateral_info(...)`
+- `AccountService#get_dcp_info(...)`
+- `AccountService#get_fee_rate(...)`
+- `AccountService#get_mmp_state(...)`
+- `AccountService#get_smp_group(...)`
+- `AccountService#get_transaction_log(...)`
+- `AccountService#get_transferable_amount(...)`
+- `AccountService#get_user_settings(...)`
+- `AccountService#manual_borrow(...)`
+- `AccountService#manual_repay(...)`
+- `AccountService#no_convert_repay(...)`
+- `AccountService#one_click_repay(...)`
+- `AccountService#reset_mmp(...)`
+- `AccountService#set_collateral_coin(...)`
+- `AccountService#set_margin_mode(...)`
+- `AccountService#set_mmp(...)`
+- `AccountService#set_price_limit(...)`
+- `AccountService#set_spot_hedging(...)`
+- `AccountService#upgrade_to_uta_pro(...)`
+- `AffiliateService#get_sub_list(...)`
+- `AffiliateService#get_user_list(...)`
+- `AssetService#get_coin_balance(...)`
+- `AssetService#get_coin_greeks(...)`
+- `AssetService#list_funding_history(...)`
+- `BrokerService#distribute_award(...)`
+- `BrokerService#get_award_info(...)`
+- `BrokerService#get_distribution_record(...)`
+- `BrokerService#get_broker_account_info(...)`
+- `BrokerService#list_broker_sub_uids(...)`
+- `BrokerService#get_broker_rate_limit_cap(...)`
+- `BrokerService#list_broker_earnings(...)`
+- `BrokerService#set_api_limit(...)`
+- `CryptoLoanService#adjust_ltv(...)`
+- `CryptoLoanService#get_adjustment_history(...)`
+- `CryptoLoanService#get_collateral_data(...)`
+- `CryptoLoanService#get_loanable_data(...)`
+- `CryptoLoanService#get_max_collateral_amount(...)`
+- `CryptoLoanService#get_max_loan(...)`
+- `CryptoLoanService#get_position(...)`
+- `CryptoLoanService#get_fixed_borrow_contract_info(...)`
+- `CryptoLoanService#get_fixed_borrow_order_info(...)`
+- `CryptoLoanService#get_fixed_borrow_order_quote(...)`
+- `CryptoLoanService#get_fixed_renew_info(...)`
+- `CryptoLoanService#get_fixed_supply_contract_info(...)`
+- `CryptoLoanService#get_fixed_supply_order_info(...)`
+- `CryptoLoanService#get_fixed_supply_order_quote(...)`
+- `CryptoLoanService#borrow_fixed(...)`
+- `CryptoLoanService#cancel_fixed_borrow_order(...)`
+- `CryptoLoanService#repay_fixed_fully(...)`
+- `CryptoLoanService#renew_fixed(...)`
+- `CryptoLoanService#repay_fixed_with_collateral(...)`
+- `CryptoLoanService#cancel_fixed_supply_order(...)`
+- `CryptoLoanService#get_flexible_borrow_history(...)`
+- `CryptoLoanService#get_flexible_ongoing_coin(...)`
+- `CryptoLoanService#get_flexible_repayment_history(...)`
+- `CryptoLoanService#borrow_flexible(...)`
+- `CryptoLoanService#repay_flexible(...)`
+- `CryptoLoanService#repay_flexible_with_collateral(...)`
+- `BotService#close_dca_bot(...)`
+- `BotService#create_dca_bot(...)`
+- `EarnService#add_liquidity(...)`
+- `EarnService#add_margin(...)`
+- `EarnService#claim_liquidity_interest(...)`
+- `EarnService#get_advance_earn_order(...)`
+- `EarnService#get_advance_earn_position(...)`
+- `EarnService#get_advance_earn_product(...)`
+- `EarnService#get_advance_earn_product_extra_info(...)`
+- `EarnService#get_double_win_leverage(...)`
+- `EarnService#get_apr_history(...)`
+- `EarnService#get_hourly_yield_history(...)`
+- `EarnService#get_order_history(...)`
+- `EarnService#get_position(...)`
+- `EarnService#get_product(...)`
+- `EarnService#get_yield_history(...)`
+- `EarnService#get_fixed_term_order(...)`
+- `EarnService#get_fixed_term_position(...)`
+- `EarnService#get_fixed_term_product(...)`
+- `EarnService#get_hold_to_earn_product(...)`
+- `EarnService#get_hold_to_earn_yield_history(...)`
+- `EarnService#get_liquidity_mining_liquidation_records(...)`
+- `EarnService#get_liquidity_mining_orders(...)`
+- `EarnService#get_liquidity_mining_positions(...)`
+- `EarnService#get_liquidity_mining_products(...)`
+- `EarnService#get_liquidity_mining_yield_records(...)`
+- `EarnService#get_rwa_nav_chart(...)`
+- `EarnService#get_rwa_order_list(...)`
+- `EarnService#get_rwa_position_list(...)`
+- `EarnService#get_rwa_product_list(...)`
+- `EarnService#get_smart_leverage_redeem_est_amount_list(...)`
+- `EarnService#get_token_daily_yield(...)`
+- `EarnService#get_token_historical_apr(...)`
+- `EarnService#get_token_hourly_yield(...)`
+- `EarnService#get_token_order_list(...)`
+- `EarnService#get_token_position(...)`
+- `EarnService#get_token_product(...)`
+- `EarnService#list_coupons(...)`
+- `EarnService#modify_earn_position(...)`
+- `EarnService#place_advance_earn_order(...)`
+- `EarnService#place_order(...)`
+- `EarnService#place_fixed_term_order(...)`
+- `EarnService#place_rwa_order(...)`
+- `EarnService#place_token_order(...)`
+- `EarnService#pwm_asset_trend(...)`
+- `EarnService#pwm_claim(...)`
+- `EarnService#pwm_create_custom_plan(...)`
+- `EarnService#pwm_fund_nav(...)`
+- `EarnService#pwm_fund_transfer(...)`
+- `EarnService#pwm_get_new_plan_detail(...)`
+- `EarnService#pwm_get_plan_detail(...)`
+- `EarnService#pwm_inst_create_fund(...)`
+- `EarnService#pwm_inst_create_investment_plan(...)`
+- `EarnService#pwm_inst_create_sub_account(...)`
+- `EarnService#pwm_inst_get_investment_plans(...)`
+- `EarnService#pwm_inst_list_funds(...)`
+- `EarnService#pwm_inst_list_orders(...)`
+- `EarnService#pwm_inst_manage_investment_plan(...)`
+- `EarnService#pwm_inst_manage_order(...)`
+- `EarnService#pwm_inst_settle_profit(...)`
+- `EarnService#pwm_invest_more(...)`
+- `EarnService#pwm_list_investment_plans(...)`
+- `EarnService#pwm_list_order(...)`
+- `EarnService#pwm_list_product_cards(...)`
+- `EarnService#pwm_query_fund_transfer_result(...)`
+- `EarnService#pwm_redeem(...)`
+- `EarnService#pwm_subscribe(...)`
+- `EarnService#redeem_fixed_term(...)`
+- `EarnService#reinvest_liquidity(...)`
+- `EarnService#remove_liquidity(...)`
+- `EarnService#set_fixed_term_auto_invest(...)`
+- `TradeService#get_execution_history(...)`
+- `BotService#close_combo_bot(...)`
+- `BotService#create_combo_bot(...)`
+- `BotService#get_combo_detail(...)`
+- `BotService#get_combo_limit(...)`
+- `BotService#close_futures_grid_bot(...)`
+- `BotService#create_futures_grid_bot(...)`
+- `BotService#get_futures_grid_detail(...)`
+- `BotService#validate_futures_grid_input(...)`
+- `BotService#close_futures_martingale_bot(...)`
+- `BotService#create_futures_martingale_bot(...)`
+- `BotService#get_futures_martingale_detail(...)`
+- `BotService#get_futures_martingale_limit(...)`
+- `BotService#close_grid_bot(...)`
+- `BotService#create_grid_bot(...)`
+- `BotService#get_grid_detail(...)`
+- `BotService#validate_grid_input(...)`
+- `MarketService#get_adl_alert(...)`
+- `MarketService#get_delivery_price(...)`
+- `MarketService#get_fee_group_info(...)`
+- `MarketService#get_funding_rate_history(...)`
+- `MarketService#get_historical_volatility(...)`
+- `MarketService#get_index_price_components(...)`
+- `MarketService#get_index_price_kline(...)`
+- `MarketService#get_instruments_info(...)`
+- `MarketService#get_insurance_pool(...)`
+- `MarketService#get_long_short_ratio(...)`
+- `MarketService#get_mark_price_kline(...)`
+- `MarketService#get_kline(...)`
+- `MarketService#get_new_delivery_price(...)`
+- `MarketService#get_open_interest(...)`
+- `MarketService#get_order_price_limit(...)`
+- `MarketService#get_orderbook(...)`
+- `MarketService#get_premium_index_price_kline(...)`
+- `MarketService#get_recent_public_trades(...)`
+- `MarketService#get_risk_limit(...)`
+- `MarketService#get_rpi_orderbook(...)`
+- `MarketService#get_server_time(...)`
+- `MarketService#get_tickers(...)`
+- `TradeService#amend_order(...)`
+- `TradeService#batch_amend_orders(...)`
+- `TradeService#batch_cancel_orders(...)`
+- `TradeService#batch_create_orders(...)`
+- `TradeService#cancel_all_orders(...)`
+- `TradeService#cancel_order(...)`
+- `TradeService#create_order(...)`
+- `TradeService#set_dcp_time_window(...)`
+- `TradeService#get_open_orders(...)`
+- `TradeService#get_order_history(...)`
+- `TradeService#get_spot_borrow_quota(...)`
+- `TradeService#pre_check_order(...)`
+- `P2pService#get_account_info(...)`
+- `P2pService#get_ads(...)`
+- `P2pService#get_all_orders(...)`
+- `P2pService#get_chat_messages(...)`
+- `P2pService#get_counterparty_user_info(...)`
+- `P2pService#get_my_ad_details(...)`
+- `P2pService#get_my_ads(...)`
+- `P2pService#get_order_detail(...)`
+- `P2pService#get_pending_orders(...)`
+- `P2pService#get_user_payment(...)`
+- `P2pService#mark_order_as_paid(...)`
+- `P2pService#create_ad(...)`
+- `P2pService#release_assets(...)`
+- `P2pService#remove_ad(...)`
+- `P2pService#send_chat_message(...)`
+- `P2pService#update_ad(...)`
+- `P2pService#upload_chat_file(...)`
+- `PositionService#add_reduce_margin(...)`
+- `PositionService#confirm_new_risk_limit(...)`
+- `PositionService#get_closed_positions(...)`
+- `PositionService#get_closed_pnl(...)`
+- `PositionService#get_move_position_history(...)`
+- `PositionService#get_positions(...)`
+- `PositionService#move_position(...)`
+- `PositionService#set_auto_add_margin(...)`
+- `PositionService#set_leverage(...)`
+- `PositionService#set_trading_stop(...)`
+- `PositionService#switch_position_mode(...)`
+- `RfqService#accept_non_lp_quote(...)`
+- `RfqService#cancel_all_quotes(...)`
+- `RfqService#cancel_all_rfqs(...)`
+- `RfqService#cancel_quote(...)`
+- `RfqService#cancel_rfq(...)`
+- `RfqService#create_quote(...)`
+- `RfqService#create_rfq(...)`
+- `RfqService#execute_quote(...)`
+- `RfqService#get_public_trades(...)`
+- `RfqService#get_quotes(...)`
+- `RfqService#get_quotes_realtime(...)`
+- `RfqService#get_config(...)`
+- `RfqService#get_rfqs(...)`
+- `RfqService#get_rfqs_realtime(...)`
+- `RfqService#get_trade_history(...)`
+- `SpotMarginService#get_historical_interest_rate(...)`
+- `SpotMarginService#get_position_tiers(...)`
+- `SpotMarginService#get_tiered_collateral_ratio(...)`
+- `SpotMarginService#get_vip_margin_data(...)`
+- `UserService#create_sub_api_key(...)`
+- `UserService#create_sub_member(...)`
+- `UserService#delete_api_key(...)`
+- `UserService#delete_sub_api_key(...)`
+- `UserService#delete_sub_member(...)`
+- `UserService#frozen_sub_member(...)`
+- `UserService#get_affiliate_custom_open_info(...)`
+- `UserService#get_member_account_type(...)`
+- `UserService#list_sub_api_keys(...)`
+- `UserService#get_api_key_info(...)`
+- `UserService#list_escrow_sub_members(...)`
+- `UserService#list_referrals(...)`
+- `UserService#list_sub_member_uids(...)`
+- `UserService#list_sub_members(...)`
+- `UserService#sign_agreement(...)`
+- `UserService#update_api_key(...)`
+- `UserService#update_sub_api_key(...)`

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bybit-exchange
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,173 @@
+# bybit-connector-ruby
+
+Official lightweight Ruby connector for the [Bybit V5 REST API](https://bybit-exchange.github.io/docs/v5/intro).
+
+`bybit-connector-ruby` wraps the Bybit V5 HTTP endpoints as a set of typed Ruby methods with keyword-arg signatures. Its goal is the same as [`pybit`](https://github.com/bybit-exchange/pybit) on the Python side: an easy-to-use, high-performance connector with a small dependency footprint.
+
+## Installation
+
+Ruby ≥ 3.0 is required (Ruby 3.3.x recommended).
+
+```
+gem install bybit-connector-ruby
+```
+
+Or in your Gemfile:
+
+```ruby
+gem 'bybit-connector-ruby'
+```
+
+## Quick Start
+
+```ruby
+require 'bybit'
+
+Bybit.configure do |c|
+  c.api_key    = ENV['BYBIT_KEY']
+  c.api_secret = ENV['BYBIT_SECRET']
+  c.testnet    = true      # omit / false for mainnet
+end
+
+client = Bybit::Client.new
+
+# Public endpoint — no auth needed
+puts client.market.get_server_time
+
+# Signed endpoint — apiKey + apiSecret required
+wallet = client.account.get_wallet_balance(account_type: 'UNIFIED')
+puts wallet['result']['list']
+
+# Place an order
+order = client.trade.create_order(
+  category: 'linear', symbol: 'BTCUSDT',
+  side: 'Buy', order_type: 'Limit', qty: '0.01',
+  price: '30000', time_in_force: 'GTC',
+)
+puts "orderId: #{order['result']['orderId']}"
+```
+
+See `examples/quickstart.rb` for a runnable script.
+
+## Configuration
+
+All options live on `Bybit::Configuration`. Either configure globally with the block:
+
+```ruby
+Bybit.configure do |c|
+  c.api_key    = ENV['BYBIT_KEY']
+  c.api_secret = ENV['BYBIT_SECRET']
+  c.testnet    = false             # default false
+  c.recv_window = '5000'           # ms, X-BAPI-RECV-WINDOW header
+  c.timeout    = 10                # Faraday timeout, seconds
+end
+```
+
+Or pass overrides to `Client.new`:
+
+```ruby
+client = Bybit::Client.new(api_key: '...', api_secret: '...', testnet: true)
+```
+
+Bring your own Faraday connection to inject retries / logging / adapters:
+
+```ruby
+conn = Faraday.new('https://api-testnet.bybit.com') do |f|
+  f.request :retry, max: 3
+  f.response :logger
+end
+Bybit.configure { |c| c.faraday_connection = conn }
+```
+
+Base URLs (exported constants):
+
+- `Bybit::BASE_URL_MAINNET` — `https://api.bybit.com`
+- `Bybit::BASE_URL_TESTNET` — `https://api-testnet.bybit.com`
+
+## Services
+
+Each API group is a property on `Bybit::Client`:
+
+- `client.market` — public market data (kline, tickers, orderbook, instruments-info, ...)
+- `client.trade` — orders (create / amend / cancel / batch / history)
+- `client.position` — positions, leverage, TP/SL, move-position
+- `client.account` — wallet, margin, collateral, fee-rate, transaction log
+- `client.asset` — coin balance, coin greeks, funding history
+- `client.user` — sub-accounts, API-key management
+- `client.affiliate` — sub-affiliate lists
+- `client.broker` — broker earnings, distributions
+- `client.crypto_loan` — flexible / fixed crypto loans
+- `client.rfq` — request-for-quote (block trades)
+- `client.spot_margin` — UTA spot margin
+- `client.earn` — earn, liquidity mining, RWA, PWM, hold-to-earn
+- `client.p2p` — P2P advertise / order / chat
+- `client.bot` — DCA / grid / futures-combo / futures-grid / martingale
+
+## Error Handling
+
+Every failure is a subclass of `Bybit::Error`:
+
+```ruby
+begin
+  client.trade.create_order(category: 'linear', symbol: 'BTCUSDT', side: 'Buy', ...)
+rescue Bybit::AuthError => e         # retCode 10003/10004/10005/... or HTTP 401/403
+  # bad key / bad sign / permission
+rescue Bybit::RateLimitError => e    # retCode 10006 / 10018 or HTTP 429
+  sleep 1 && retry
+rescue Bybit::TimeoutError => e      # Faraday::TimeoutError
+rescue Bybit::NetworkError => e      # Faraday::ConnectionFailed / SSLError
+rescue Bybit::ServerError => e       # HTTP 5xx w/ non-JSON body
+rescue Bybit::ClientError => e       # HTTP 4xx w/ non-JSON body (WAF, CDN, etc.)
+rescue Bybit::ParseError => e        # unrecognized body shape; e.body holds raw payload
+rescue Bybit::ApiError => e          # any other retCode != 0 — catch-all API error
+end
+```
+
+Full hierarchy:
+
+- `Bybit::Error` (StandardError)
+  - `Bybit::ConfigurationError` — missing api_key / conflicting options
+  - `Bybit::TransportError`
+    - `Bybit::TimeoutError`
+    - `Bybit::NetworkError`
+    - `Bybit::ServerError` (5xx w/o body)
+    - `Bybit::ClientError` (non-auth 4xx w/o body)
+    - `Bybit::ParseError` — body did not parse or shape mismatch (has `#body`, `#http_status`)
+  - `Bybit::ApiError` — Bybit V5 body with retCode != 0
+    - `Bybit::AuthError`
+    - `Bybit::RateLimitError`
+
+Every `ApiError` exposes `#ret_code`, `#ret_msg`, `#result`, `#time`, `#http_status`. See the [Bybit V5 error-code list](https://bybit-exchange.github.io/docs/v5/error) for meanings.
+
+## Return Value
+
+Every service method returns the raw parsed JSON as a `Hash`:
+
+```ruby
+response = client.market.get_kline(category: 'spot', symbol: 'BTCUSDT', interval: '1')
+response['retCode']    # => 0
+response['retMsg']     # => 'OK'
+response['result']     # => { 'category' => 'spot', 'symbol' => 'BTCUSDT', 'list' => [...] }
+response['time']       # => 1234567890000
+```
+
+## Testnet
+
+Toggle `testnet: true` for [https://testnet.bybit.com](https://testnet.bybit.com):
+
+```ruby
+client = Bybit::Client.new(api_key: ENV['BYBIT_TESTNET_KEY'], api_secret: ENV['BYBIT_TESTNET_SECRET'], testnet: true)
+```
+
+## Development
+
+```
+bundle install
+bundle exec rspec       # tests
+bundle exec rubocop     # lint
+bundle exec rake        # both
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

data/examples/quickstart.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# End-to-end quickstart — public + signed calls + rescue matrix.
+# Run with:  BYBIT_KEY=... BYBIT_SECRET=... ruby examples/quickstart.rb
+
+require 'bybit'
+
+Bybit.configure do |c|
+  c.api_key    = ENV['BYBIT_KEY']
+  c.api_secret = ENV['BYBIT_SECRET']
+  c.testnet    = true          # flip to false for mainnet
+end
+
+client = Bybit::Client.new
+
+# 1. Public endpoint — server time (no auth needed)
+puts '--- server time ---'
+puts client.market.get_server_time.inspect
+
+# 2. Signed endpoint — wallet balance
+puts '--- wallet balance ---'
+begin
+  wallet = client.account.get_wallet_balance(account_type: 'UNIFIED')
+  puts wallet['result']['list'].inspect
+rescue Bybit::AuthError => e
+  warn "auth failed: [#{e.ret_code}] #{e.ret_msg}"
+rescue Bybit::RateLimitError => e
+  warn "rate-limited: #{e.ret_msg}"
+rescue Bybit::TimeoutError => e
+  warn "timeout: #{e.message}"
+rescue Bybit::NetworkError => e
+  warn "network: #{e.message}"
+rescue Bybit::ApiError => e
+  warn "api error [#{e.ret_code}]: #{e.ret_msg}"
+end

data/lib/bybit/authentication.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'openssl'
+
+module Bybit
+  # HMAC-SHA256 signer for the Bybit V5 REST API.
+  # Payload format: timestamp + api_key + recv_window + (query_string OR request_body).
+  module Authentication
+    module_function
+
+    def sign_v5(api_secret, timestamp, api_key, recv_window, payload)
+      msg = "#{timestamp}#{api_key}#{recv_window}#{payload}"
+      OpenSSL::HMAC.hexdigest('SHA256', api_secret, msg)
+    end
+  end
+end

data/lib/bybit/client.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# gen-sdk-ruby:service-requires:start
+require 'bybit/rest_api/account_service'
+require 'bybit/rest_api/affiliate_service'
+require 'bybit/rest_api/asset_service'
+require 'bybit/rest_api/bot_service'
+require 'bybit/rest_api/broker_service'
+require 'bybit/rest_api/crypto_loan_service'
+require 'bybit/rest_api/earn_service'
+require 'bybit/rest_api/market_service'
+require 'bybit/rest_api/p2p_service'
+require 'bybit/rest_api/position_service'
+require 'bybit/rest_api/rfq_service'
+require 'bybit/rest_api/spot_margin_service'
+require 'bybit/rest_api/trade_service'
+require 'bybit/rest_api/user_service'
+# gen-sdk-ruby:service-requires:end
+
+module Bybit
+  # Global configuration block — Bybit.configure { |c| c.api_key = ... }
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+  end
+
+  class Client
+    # gen-sdk-ruby:client-readers:start
+    attr_reader :account, :affiliate, :asset, :bot, :broker, :crypto_loan, :earn,
+                :market, :p2p, :position, :rfq, :spot_margin, :trade, :user
+
+    # gen-sdk-ruby:client-readers:end
+
+    def initialize(config = nil, **overrides)
+      cfg = (config || Bybit.configuration).dup
+      overrides.each { |k, v| cfg.public_send("#{k}=", v) }
+      session = Session.new(cfg)
+      @config = cfg
+
+      # gen-sdk-ruby:client-inits:start
+      @account = RestApi::AccountService.new(session)
+      @affiliate = RestApi::AffiliateService.new(session)
+      @asset = RestApi::AssetService.new(session)
+      @bot = RestApi::BotService.new(session)
+      @broker = RestApi::BrokerService.new(session)
+      @crypto_loan = RestApi::CryptoLoanService.new(session)
+      @earn = RestApi::EarnService.new(session)
+      @market = RestApi::MarketService.new(session)
+      @p2p = RestApi::P2pService.new(session)
+      @position = RestApi::PositionService.new(session)
+      @rfq = RestApi::RfqService.new(session)
+      @spot_margin = RestApi::SpotMarginService.new(session)
+      @trade = RestApi::TradeService.new(session)
+      @user = RestApi::UserService.new(session)
+      # gen-sdk-ruby:client-inits:end
+    end
+
+    # Redacted #inspect so console printing doesn't leak the secret.
+    def inspect
+      "#<Bybit::Client testnet=#{@config.testnet} base_url=#{@config.resolved_base_url}>"
+    end
+    alias to_s inspect
+  end
+end

data/lib/bybit/configuration.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Bybit
+  BASE_URL_MAINNET    = 'https://api.bybit.com'
+  BASE_URL_TESTNET    = 'https://api-testnet.bybit.com'
+  DEFAULT_RECV_WINDOW = '5000'
+  DEFAULT_TIMEOUT     = 10
+
+  class Configuration
+    # Attributes safe to expose in serialized form. Anything not in this
+    # allowlist is dropped from to_json / as_json / marshal_dump — no accidental
+    # secret leakage through pino/winston-style default serializers.
+    SAFE_ATTRS = %i[testnet base_url recv_window timeout].freeze
+
+    attr_accessor :api_key, :api_secret, :testnet, :base_url,
+                  :recv_window, :timeout, :faraday_connection
+
+    def initialize
+      @testnet = false
+      @recv_window = DEFAULT_RECV_WINDOW
+      @timeout = DEFAULT_TIMEOUT
+    end
+
+    def resolved_base_url
+      base_url || (testnet ? BASE_URL_TESTNET : BASE_URL_MAINNET)
+    end
+
+    # Serialization-safe hash used by as_json / to_json / marshal_dump.
+    def to_h_safe
+      {
+        api_key: redact(@api_key),
+        api_secret: redact(@api_secret),
+        testnet: @testnet,
+        base_url: resolved_base_url,
+        recv_window: @recv_window,
+        timeout: @timeout
+      }
+    end
+
+    def to_json(*args)
+      require 'json'
+      to_h_safe.to_json(*args)
+    end
+
+    def as_json(*_)
+      to_h_safe.transform_keys(&:to_s)
+    end
+
+    def marshal_dump
+      to_h_safe
+    end
+
+    # Un-marshalling a redacted Configuration is intentionally lossy — callers
+    # should never round-trip credentials through Marshal.
+    def marshal_load(hash)
+      hash.each { |k, v| instance_variable_set("@#{k}", v) }
+    end
+
+    # Redact credentials from #inspect and #to_s so a stray puts/logger call
+    # doesn't leak the secret into log aggregation.
+    def inspect
+      "#<Bybit::Configuration api_key=#{redact(@api_key)} api_secret=#{redact(@api_secret)} testnet=#{@testnet} base_url=#{resolved_base_url}>"
+    end
+    alias to_s inspect
+
+    private
+
+    def redact(value)
+      # Use .to_s.empty? so an Integer / other non-String credential (rare but
+      # possible via misconfig) doesn't crash with NoMethodError.
+      value.nil? || value.to_s.empty? ? '(unset)' : '[REDACTED]'
+    end
+  end
+end