hyperliquid 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce12eae948710ac0527586206ef346535631855e2e99e5d858bbcbfab0440826
-  data.tar.gz: 58cfa00339c797844b38a1744392a4589c97a9d7c61b3d6782411a1f4a2adc05
+  metadata.gz: f5ac9afd372d7362c7d984fa21d21ef3822a2b3a2beebeb2067f088055be2b7b
+  data.tar.gz: b45bb221a66d07fa76d5f53375c24aef11f55a421cf0f33c038c53cbf49b797e
 SHA512:
-  metadata.gz: 146b89a2874c1410b470cf2e9c795af60915dc4b5b9aaaad40228823230e8c738292a7c480e873f5732a896cdd4aa502622c8df47fa21321b51894efd5948a16
-  data.tar.gz: 870019afb083c7a5864361335fc5294d941d47e4318f38f5acd548ee63bfde3f364928f8f71690bca76db5aa68255478bc205a91c79f5737bdbdb78ce77f073e
+  metadata.gz: d55505a3ebf3595363542005aa5b6e3400678b22bd6689ffb38318f4f8450362d1e3ae2a8041a877dab82d1343f28bc48ba61f6a50a02dd81fbd2989bcad2660
+  data.tar.gz: 17e7a2df87f5f30b3ce79f6767ba5da9a95d097990b2b990ddc7d71bee2600c15630c3b3f96bcf350a151479eebd8520eb38f74949bad2e9fc6026a23d740d80

data/.rubocop.yml

@@ -10,6 +10,10 @@ Metrics/MethodLength:
 Metrics/AbcSize:
   Max: 25
 
+# Disable class length checks so rubocop doesn't complain that we implement all of Hyperliquid's endpoints
+Metrics/ClassLength:
+  Enabled: false
+
 # Allow longer blocks in specs - this is normal for tests
 Metrics/BlockLength:
   Exclude:

data/CHANGELOG.md

@@ -1,5 +1,13 @@
-## [Unreleased]
+## [Ruby Hyperliquid SDK Changelog]
 
 ## [0.1.0] - 2025-08-21
 
-- Initial release
+- Initial release which includes info endpoints for market and user perps data
+
+## [0.1.1] - 2025-09-23
+
+- Fixed retry logic, make retry logic disabled by default
+
+## [0.2.0] - 2025-09-24
+
+- Add info endpoints for user spot data

data/README.md

@@ -2,7 +2,7 @@
 
 A Ruby SDK for interacting with the Hyperliquid decentralized exchange API.
 
-This is v0.1.0 - an alpha-stage read-only implementation focusing on the Info API endpoints for market data, user information, and order book data.
+The latest version is v0.2.0 - a read-only implementation focusing on the Info API endpoints for market data, user information, and order book data.
 
 ## Installation
 
@@ -37,54 +37,254 @@ testnet_sdk = Hyperliquid.new(testnet: true)
 info = sdk.info
 ```
 
-### Info API Methods
-
-The SDK provides access to all Hyperliquid Info API endpoints:
-
-#### Market Data
+### Supported APIs
+
+The SDK provides access to the following Hyperliquid APIs:
+
+#### Info Methods
+- `all_mids()` - Retrieve mids for all coins
+- `open_orders(user)` - Retrieve a user's open orders
+- `frontend_open_orders(user, dex: nil)` - Retrieve a user's open orders with additional frontend info
+- `user_fills(user)` - Retrieve a user's fills
+- `user_fills_by_time(user, start_time, end_time = nil)` - Retrieve a user's fills by time (optional end time)
+- `user_rate_limit(user)` - Query user rate limits
+- `order_status(user, oid)` - Query order status by order id (oid)
+- `order_status_by_cloid(user, cloid)` - Query order status by client order id (cloid)
+- `l2_book(coin)` - L2 book snapshot (Perpetuals and Spot)
+- `candles_snapshot(coin, interval, start_time, end_time)` - Candle snapshot (Perpetuals and Spot)
+- `max_builder_fee(user, builder)` - Check builder fee approval
+- `historical_orders(user, start_time = nil, end_time = nil)` - Retrieve a user's historical orders
+- `user_twap_slice_fills(user, start_time = nil, end_time = nil)` - Retrieve a user's TWAP slice fills
+- `user_subaccounts(user)` - Retrieve a user's subaccounts
+- `vault_details(vault_address, user = nil)` - Retrieve details for a vault
+- `user_vault_equities(user)` - Retrieve a user's vault deposits
+- `user_role(user)` - Query a user's role
+- `portfolio(user)` - Query a user's portfolio
+- `referral(user)` - Query a user's referral information
+- `user_fees(user)` - Query a user's fees and fee schedule
+- `delegations(user)` - Query a user's staking delegations
+- `delegator_summary(user)` - Query a user's staking summary
+- `delegator_history(user)` - Query a user's staking history
+- `delegator_rewards(user)` - Query a user's staking rewards
+
+##### Perpetuals Methods
+- `perp_dexs()` - Retrieve all perpetual DEXs
+- `meta(dex: nil)` - Get asset metadata (optionally for a specific perp DEX)
+- `meta_and_asset_ctxs()` - Get extended asset metadata
+- `user_state(user, dex: nil)` - Retrieve user's perpetuals account summary (optionally for a specific perp DEX)
+- `predicted_fundings()` - Retrieve predicted funding rates across venues
+- `perps_at_open_interest_cap()` - Query perps at open interest caps
+- `perp_deploy_auction_status()` - Retrieve Perp Deploy Auction status
+- `active_asset_data(user, coin)` - Retrieve a user's active asset data for a coin
+- `perp_dex_limits(dex)` - Retrieve builder-deployed perp market limits for a DEX
+- `user_funding(user, start_time, end_time = nil)` - Retrieve a user's funding history (optional end time)
+- `user_non_funding_ledger_updates(user, start_time, end_time = nil)` - Retrieve a user's non-funding ledger updates. Non-funding ledger updates include deposits, transfers, and withdrawals. (optional end time)
+- `funding_history(coin, start_time, end_time = nil)` - Retrieve historical funding rates (optional end time)
+
+##### Spot Methods
+- `spot_meta()` - Retrieve spot metadata (tokens and universe)
+- `spot_meta_and_asset_ctxs()` - Retrieve spot metadata and asset contexts
+- `spot_balances(user)` - Retrieve a user's spot token balances
+- `spot_deploy_state(user)` - Retrieve Spot Deploy Auction information
+- `spot_pair_deploy_auction_status()` - Retrieve Spot Pair Deploy Auction status
+- `token_details(token_id)` - Retrieve information about a token by tokenId
+
+#### Examples: Info
 
 ```ruby
-# Get all market mid prices
+# Retrieve mids for all coins
 mids = sdk.info.all_mids
 # => { "BTC" => "50000", "ETH" => "3000", ... }
 
-# Get asset metadata
-meta = sdk.info.meta
-# => { "universe" => [...] }
+user_address = "0x..."
 
-# Get extended asset metadata with contexts
-meta_ctxs = sdk.info.meta_and_asset_ctxs  
-# => { "universe" => [...], "assetCtxs" => [...] }
+# Retrieve a user's open orders
+orders = sdk.info.open_orders(user_address)
+# => [{ "coin" => "BTC", "sz" => "0.1", "px" => "50000", "side" => "A" }]
+
+# Retrieve a user's open orders with additional frontend info
+frontend_orders = sdk.info.frontend_open_orders(user_address)
+# => [{ "coin" => "BTC", "isTrigger" => false, ... }]
+
+# Retrieve a user's fills
+fills = sdk.info.user_fills(user_address)
+# => [{ "coin" => "BTC", "sz" => "0.1", "px" => "50000", "side" => "A", "time" => 1234567890 }]
+
+# Retrieve a user's fills by time
+start_time_ms = 1_700_000_000_000
+end_time_ms = start_time_ms + 86_400_000
+fills_by_time = sdk.info.user_fills_by_time(user_address, start_time_ms, end_time_ms)
+# => [{ "coin" => "ETH", "px" => "3000", "time" => start_time_ms }, ...]
 
-# Get L2 order book for a coin
+# Query user rate limits
+rate_limit = sdk.info.user_rate_limit(user_address)
+# => { "nRequestsUsed" => 100, "nRequestsCap" => 10000 }
+
+# Query order status by oid
+order_id = 12345
+status_by_oid = sdk.info.order_status(user_address, order_id)
+# => { "status" => "filled", ... }
+
+# Query order status by cloid
+cloid = "client-order-id-123"
+status_by_cloid = sdk.info.order_status_by_cloid(user_address, cloid)
+# => { "status" => "cancelled", ... }
+
+# L2 order book snapshot
 book = sdk.info.l2_book("BTC")
 # => { "coin" => "BTC", "levels" => [[asks], [bids]], "time" => ... }
 
-# Get candlestick data
-candles = sdk.info.candles_snapshot("BTC", "1h", start_time, end_time)
+# Candle snapshot
+candles = sdk.info.candles_snapshot("BTC", "1h", start_time_ms, end_time_ms)
 # => [{ "t" => ..., "o" => "50000", "h" => "51000", "l" => "49000", "c" => "50500", "v" => "100" }]
+
+# Check builder fee approval
+builder_address = "0x..."
+fee_approval = sdk.info.max_builder_fee(user_address, builder_address)
+# => { "approved" => true, ... }
+
+# Retrieve a user's historical orders
+hist_orders = sdk.info.historical_orders(user_address)
+# => [{ "oid" => 123, "coin" => "BTC", ... }]
+hist_orders_ranged = sdk.info.historical_orders(user_address, start_time_ms, end_time_ms)
+# => []
+
+# Retrieve a user's TWAP slice fills
+twap_fills = sdk.info.user_twap_slice_fills(user_address)
+# => [{ "sliceId" => 1, "coin" => "ETH", "sz" => "1.0" }, ...]
+twap_fills_ranged = sdk.info.user_twap_slice_fills(user_address, start_time_ms, end_time_ms)
+# => []
+
+# Retrieve a user's subaccounts
+subaccounts = sdk.info.user_subaccounts(user_address)
+# => ["0x1111...", ...]
+
+# Retrieve details for a vault
+vault_addr = "0x..."
+vault = sdk.info.vault_details(vault_addr)
+# => { "vaultAddress" => vault_addr, ... }
+vault_with_user = sdk.info.vault_details(vault_addr, user_address)
+# => { "vaultAddress" => vault_addr, "user" => user_address, ... }
+
+# Retrieve a user's vault deposits
+vault_deposits = sdk.info.user_vault_equities(user_address)
+# => [{ "vaultAddress" => "0x...", "equity" => "123.45" }, ...]
+
+# Query a user's role
+role = sdk.info.user_role(user_address)
+# => { "role" => "tradingUser" }
+
+# Query a user's portfolio
+portfolio = sdk.info.portfolio(user_address)
+# => [["day", { "pnlHistory" => [...], "vlm" => "0.0" }], ...]
+
+# Query a user's referral information
+referral = sdk.info.referral(user_address)
+# => { "referredBy" => { "referrer" => "0x..." }, ... }
+
+# Query a user's fees
+fees = sdk.info.user_fees(user_address)
+# => { "userAddRate" => "0.0001", "feeSchedule" => { ... } }
+
+# Query a user's staking delegations
+delegations = sdk.info.delegations(user_address)
+# => [{ "validator" => "0x...", "amount" => "100.0" }, ...]
+
+# Query a user's staking summary
+summary = sdk.info.delegator_summary(user_address)
+# => { "delegated" => "12060.16529862", ... }
+
+# Query a user's staking history
+history = sdk.info.delegator_history(user_address)
+# => [{ "time" => 1_736_726_400_073, "delta" => { ... } }, ...]
+
+# Query a user's staking rewards
+rewards = sdk.info.delegator_rewards(user_address)
+# => [{ "time" => 1_736_726_400_073, "source" => "delegation", "totalAmount" => "0.123" }, ...]
 ```
 
-#### User Data
+Note: `l2_book` and `candles_snapshot` work for both Perpetuals and Spot. For spot, use `"{BASE}/USDC"` when available (e.g., `"PURR/USDC"`). Otherwise, use the index alias `"@{index}"` from `spot_meta["universe"]`.
+
+##### Examples: Perpetuals
 
 ```ruby
-user_address = "0x..." # Wallet address
+# Retrieve all perpetual DEXs
+perp_dexs = sdk.info.perp_dexs
+# => [nil, { "name" => "test", "full_name" => "test dex", ... }]
 
-# Get user's open orders
-orders = sdk.info.open_orders(user_address)
-# => [{ "coin" => "BTC", "sz" => "0.1", "px" => "50000", "side" => "A" }]
+# Retrieve perpetuals metadata (optionally for a specific perp dex)
+meta = sdk.info.meta
+# => { "universe" => [...] }
+meta = sdk.info.meta(dex: "perp-dex-name")
+# => { "universe" => [...] }
 
-# Get user's fill history
-fills = sdk.info.user_fills(user_address)
-# => [{ "coin" => "BTC", "sz" => "0.1", "px" => "50000", "side" => "A", "time" => 1234567890 }]
+# Retrieve perpetuals asset contexts (includes mark price, current funding, open interest, etc.)
+meta_ctxs = sdk.info.meta_and_asset_ctxs  
+# => { "universe" => [...], "assetCtxs" => [...] }
 
-# Get user's trading state (positions, balances)
+# Retrieve user's perpetuals account summary (optionally for a specific perp dex)
 state = sdk.info.user_state(user_address)
 # => { "assetPositions" => [...], "marginSummary" => {...} }
+state = sdk.info.user_state(user_address, dex: "perp-dex-name")
+# => { "assetPositions" => [...], "marginSummary" => {...} }
+
+# Retrieve a user's funding history or non-funding ledger updates (optional end_time)
+funding = sdk.info.user_funding(user_address, start_time)
+# => [{ "delta" => { "type" => "funding", ... }, "time" => ... }]
+funding = sdk.info.user_funding(user_address, start_time, end_time)
+# => [{ "delta" => { "type" => "funding", ... }, "time" => ... }]
+
+# Retrieve historical funding rates
+hist = sdk.info.funding_history("ETH", start_time)
+# => [{ "coin" => "ETH", "fundingRate" => "...", "time" => ... }]
+
+# Retrieve predicted funding rates for different venues
+pred = sdk.info.predicted_fundings
+# => [["AVAX", [["HlPerp", { "fundingRate" => "0.0000125", "nextFundingTime" => ... }], ...]], ...]
+
+# Query perps at open interest caps
+oi_capped = sdk.info.perps_at_open_interest_cap
+# => ["BADGER", "CANTO", ...]
+
+# Retrieve information about the Perp Deploy Auction
+auction = sdk.info.perp_deploy_auction_status
+# => { "startTimeSeconds" => ..., "durationSeconds" => ..., "startGas" => "500.0", ... }
+
+# Retrieve User's Active Asset Data
+aad = sdk.info.active_asset_data(user_address, "APT")
+# => { "user" => user_address, "coin" => "APT", "leverage" => { "type" => "cross", "value" => 3 }, ... }
+
+# Retrieve Builder-Deployed Perp Market Limits
+limits = sdk.info.perp_dex_limits("builder-dex")
+# => { "totalOiCap" => "10000000.0", "oiSzCapPerPerp" => "...", ... }
+```
+
+##### Examples: Spot
+
+```ruby
+# Retrieve spot metadata
+spot_meta = sdk.info.spot_meta
+# => { "tokens" => [...], "universe" => [...] }
 
-# Get order status  
-status = sdk.info.order_status(user_address, order_id)
-# => { "status" => "filled", "sz" => "0.1", "px" => "50000" }
+# Retrieve spot asset contexts
+spot_meta_ctxs = sdk.info.spot_meta_and_asset_ctxs
+# => [ { "tokens" => [...], "universe" => [...] }, [ { "midPx" => "...", ... } ] ]
+
+# Retrieve a user's token balances
+balances = sdk.info.spot_balances(user_address)
+# => { "balances" => [{ "coin" => "USDC", "token" => 0, "total" => "..." }, ...] }
+
+# Retrieve information about the Spot Deploy Auction
+deploy_state = sdk.info.spot_deploy_state(user_address)
+# => { "states" => [...], "gasAuction" => { ... } }
+
+# Retrieve information about the Spot Pair Deploy Auction
+pair_status = sdk.info.spot_pair_deploy_auction_status
+# => { "startTimeSeconds" => ..., "durationSeconds" => ..., "startGas" => "...", ... }
+
+# Retrieve information about a token by onchain id in 34-character hexadecimal format
+details = sdk.info.token_details("0x00000000000000000000000000000000")
+# => { "name" => "TEST", "maxSupply" => "...", "midPx" => "...", ... }
 ```
 
 ### Configuration
@@ -154,34 +354,6 @@ Available error classes:
 - `Hyperliquid::NetworkError` - Connection issues
 - `Hyperliquid::TimeoutError` - Request timeouts
 
-## API Reference
-
-### Hyperliquid.new(options = {})
-
-Creates a new SDK instance.
-
-**Parameters:**
-- `testnet` (Boolean) - Use testnet instead of mainnet (default: false)  
-- `timeout` (Integer) - Request timeout in seconds (default: 30)
-- `retry_enabled` (Boolean) - Enable automatic retry logic for transient failures (default: false)
-
-### Info API Methods
-
-All Info methods return parsed JSON responses from the Hyperliquid API.
-
-#### Market Data Methods
-- `all_mids()` - Get all market mid prices
-- `meta()` - Get asset metadata
-- `meta_and_asset_ctxs()` - Get extended asset metadata
-- `l2_book(coin)` - Get L2 order book for a coin
-- `candles_snapshot(coin, interval, start_time, end_time)` - Get candlestick data
-
-#### User Data Methods  
-- `open_orders(user)` - Get user's open orders
-- `user_fills(user)` - Get user's fill history
-- `user_state(user)` - Get user's trading state
-- `order_status(user, oid)` - Get order status
-
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -208,11 +380,11 @@ rake rubocop
 
 ## Roadmap
 
-This is v0.1.0 with read-only Info API support. Future versions will include:
+The latest version implements read-only Info API support. Future versions will include:
 
-- v0.2.0: Trading API (place orders, cancel orders, etc.)
-- v0.3.0: WebSocket support for real-time data
-- v0.4.0: Advanced trading features
+- Trading API (place orders, cancel orders, etc.)
+- WebSocket support for real-time data
+- Advanced trading features
 
 ## Contributing
 

data/lib/hyperliquid/info.rb

@@ -7,6 +7,10 @@ module Hyperliquid
       @client = client
     end
 
+    # ============================
+    # Info
+    # ============================
+
     # Get all market mid prices
     # @return [Hash] Hash containing mid prices for all markets
     def all_mids
@@ -15,9 +19,22 @@ module Hyperliquid
 
     # Get a user's open orders
     # @param user [String] Wallet address
+    # @param dex [String, nil] Optional perp dex name
     # @return [Array] Array of open orders for the user
-    def open_orders(user)
-      @client.post(Constants::INFO_ENDPOINT, { type: 'openOrders', user: user })
+    def open_orders(user, dex: nil)
+      body = { type: 'openOrders', user: user }
+      body[:dex] = dex if dex
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Get a user's open orders with additional frontend info
+    # @param user [String] Wallet address
+    # @param dex [String, nil] Optional perp dex name
+    # @return [Array]
+    def frontend_open_orders(user, dex: nil)
+      body = { type: 'frontendOpenOrders', user: user }
+      body[:dex] = dex if dex
+      @client.post(Constants::INFO_ENDPOINT, body)
     end
 
     # Get a user's fill history
@@ -27,6 +44,24 @@ module Hyperliquid
       @client.post(Constants::INFO_ENDPOINT, { type: 'userFills', user: user })
     end
 
+    # Get a user's fills within a time range
+    # @param user [String] Wallet address
+    # @param start_time [Integer] Start timestamp in milliseconds
+    # @param end_time [Integer, nil] Optional end timestamp in milliseconds
+    # @return [Array]
+    def user_fills_by_time(user, start_time, end_time = nil)
+      body = { type: 'userFillsByTime', user: user, startTime: start_time }
+      body[:endTime] = end_time if end_time
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Query user rate limits and usage
+    # @param user [String] Wallet address
+    # @return [Hash]
+    def user_rate_limit(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'userRateLimit', user: user })
+    end
+
     # Get order status by order ID
     # @param user [String] Wallet address
     # @param oid [Integer] Order ID
@@ -35,23 +70,12 @@ module Hyperliquid
       @client.post(Constants::INFO_ENDPOINT, { type: 'orderStatus', user: user, oid: oid })
     end
 
-    # Get user's trading state
+    # Get order status by client order ID (cloid)
     # @param user [String] Wallet address
-    # @return [Hash] User's trading state including positions and balances
-    def user_state(user)
-      @client.post(Constants::INFO_ENDPOINT, { type: 'clearinghouseState', user: user })
-    end
-
-    # Get metadata for all assets
-    # @return [Hash] Metadata for all tradable assets
-    def meta
-      @client.post(Constants::INFO_ENDPOINT, { type: 'meta' })
-    end
-
-    # Get metadata for all assets including universe info
-    # @return [Hash] Extended metadata for all assets with universe information
-    def meta_and_asset_ctxs
-      @client.post(Constants::INFO_ENDPOINT, { type: 'metaAndAssetCtxs' })
+    # @param cloid [String] Client order ID
+    # @return [Hash] Order status information
+    def order_status_by_cloid(user, cloid)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'orderStatus', user: user, cloid: cloid })
     end
 
     # Get L2 order book for a coin
@@ -78,5 +102,262 @@ module Hyperliquid
                      }
                    })
     end
+
+    # Check builder fee approval
+    # @param user [String] Wallet address
+    # @param builder [String] Builder address
+    # @return [Hash]
+    def max_builder_fee(user, builder)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'maxBuilderFee', user: user, builder: builder })
+    end
+
+    # Retrieve a user's historical orders
+    # @param user [String] Wallet address
+    # @param start_time [Integer, nil] Optional start timestamp in milliseconds
+    # @param end_time [Integer, nil] Optional end timestamp in milliseconds
+    # @return [Array]
+    def historical_orders(user, start_time = nil, end_time = nil)
+      body = { type: 'historicalOrders', user: user }
+      body[:startTime] = start_time if start_time
+      body[:endTime] = end_time if end_time
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Retrieve a user's TWAP slice fills
+    # @param user [String] Wallet address
+    # @param start_time [Integer, nil] Optional start timestamp in milliseconds
+    # @param end_time [Integer, nil] Optional end timestamp in milliseconds
+    # @return [Array]
+    def user_twap_slice_fills(user, start_time = nil, end_time = nil)
+      body = { type: 'userTwapSliceFills', user: user }
+      body[:startTime] = start_time if start_time
+      body[:endTime] = end_time if end_time
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Retrieve a user's subaccounts
+    # @param user [String]
+    # @return [Array]
+    def user_subaccounts(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'subaccounts', user: user })
+    end
+
+    # Retrieve details for a vault
+    # @param vault_address [String] Vault address
+    # @param user [String, nil] Optional wallet address
+    # @return [Hash]
+    def vault_details(vault_address, user = nil)
+      body = { type: 'vaultDetails', vaultAddress: vault_address }
+      body[:user] = user if user
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Retrieve a user's vault deposits
+    # @param user [String] Wallet address
+    # @return [Array]
+    def user_vault_equities(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'userVaultEquities', user: user })
+    end
+
+    # Query a user's role
+    # @param user [String]
+    # @return [Hash]
+    def user_role(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'userRole', user: user })
+    end
+
+    # Query a user's portfolio time series
+    # @param user [String]
+    # @return [Array]
+    def portfolio(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'portfolio', user: user })
+    end
+
+    # Query a user's referral information
+    # @param user [String]
+    # @return [Hash]
+    def referral(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'referral', user: user })
+    end
+
+    # Query a user's effective fee rates and schedule
+    # @param user [String]
+    # @return [Hash]
+    def user_fees(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'userFees', user: user })
+    end
+
+    # Query a user's staking delegations
+    # @param user [String]
+    # @return [Array]
+    def delegations(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'delegations', user: user })
+    end
+
+    # Query a user's staking summary
+    # @param user [String]
+    # @return [Hash]
+    def delegator_summary(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'delegatorSummary', user: user })
+    end
+
+    # Query a user's staking history
+    # @param user [String]
+    # @return [Array]
+    def delegator_history(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'delegatorHistory', user: user })
+    end
+
+    # Query a user's staking rewards
+    # @param user [String]
+    # @return [Array]
+    def delegator_rewards(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'delegatorRewards', user: user })
+    end
+
+    # ============================
+    # Info: Perpetuals
+    # ============================
+
+    # Retrieve all perpetual dexs
+    # @return [Array]
+    def perp_dexs
+      @client.post(Constants::INFO_ENDPOINT, { type: 'perpDexs' })
+    end
+
+    # Get metadata for all assets
+    # @return [Hash] Metadata for all tradable assets
+    # @param dex [String, nil] Optional perp dex name (defaults to first perp dex when not provided)
+    def meta(dex: nil)
+      body = { type: 'meta' }
+      body[:dex] = dex if dex
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Get metadata for all assets including universe info
+    # @return [Hash] Extended metadata for all assets with universe information
+    def meta_and_asset_ctxs
+      @client.post(Constants::INFO_ENDPOINT, { type: 'metaAndAssetCtxs' })
+    end
+
+    # Get user's trading state
+    # @param user [String] Wallet address
+    # @param dex [String, nil] Optional perp dex name
+    # @return [Hash] User's trading state including positions and balances
+    def user_state(user, dex: nil)
+      body = { type: 'clearinghouseState', user: user }
+      body[:dex] = dex if dex
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Retrieve predicted funding rates for different venues
+    # @return [Array]
+    def predicted_fundings
+      @client.post(Constants::INFO_ENDPOINT, { type: 'predictedFundings' })
+    end
+
+    # Query perps at open interest caps
+    # @return [Array]
+    def perps_at_open_interest_cap
+      @client.post(Constants::INFO_ENDPOINT, { type: 'perpsAtOpenInterestCap' })
+    end
+
+    # Retrieve information about the Perp Deploy Auction
+    # @return [Hash]
+    def perp_deploy_auction_status
+      @client.post(Constants::INFO_ENDPOINT, { type: 'perpDeployAuctionStatus' })
+    end
+
+    # Retrieve User's Active Asset Data
+    # @param user [String]
+    # @param coin [String]
+    # @return [Hash]
+    def active_asset_data(user, coin)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'activeAssetData', user: user, coin: coin })
+    end
+
+    # Retrieve Builder-Deployed Perp Market Limits
+    # @param dex [String]
+    # @return [Hash]
+    def perp_dex_limits(dex)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'perpDexLimits', dex: dex })
+    end
+
+    # Retrieve a user's funding history
+    # @param user [String]
+    # @param start_time [Integer]
+    # @param end_time [Integer, nil]
+    # @return [Array]
+    def user_funding(user, start_time, end_time = nil)
+      body = { type: 'userFunding', user: user, startTime: start_time }
+      body[:endTime] = end_time if end_time
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Retrieve a user's non-funding ledger updates
+    # @param user [String]
+    # @param start_time [Integer]
+    # @param end_time [Integer, nil]
+    # @return [Array]
+    def user_non_funding_ledger_updates(user, start_time, end_time = nil)
+      body = { type: 'userNonFundingLedgerUpdates', user: user, startTime: start_time }
+      body[:endTime] = end_time if end_time
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # Retrieve historical funding rates
+    # @param coin [String]
+    # @param start_time [Integer]
+    # @param end_time [Integer, nil]
+    # @return [Array]
+    def funding_history(coin, start_time, end_time = nil)
+      body = { type: 'fundingHistory', coin: coin, startTime: start_time }
+      body[:endTime] = end_time if end_time
+      @client.post(Constants::INFO_ENDPOINT, body)
+    end
+
+    # ============================
+    # Info: Spot
+    # ============================
+
+    # Get spot metadata
+    # @return [Hash] Spot tokens and universe metadata
+    def spot_meta
+      @client.post(Constants::INFO_ENDPOINT, { type: 'spotMeta' })
+    end
+
+    # Get spot metadata and asset contexts
+    # @return [Array] [spot_meta, spot_asset_ctxs]
+    def spot_meta_and_asset_ctxs
+      @client.post(Constants::INFO_ENDPOINT, { type: 'spotMetaAndAssetCtxs' })
+    end
+
+    # Get a user's spot token balances
+    # @param user [String] Wallet address
+    # @return [Hash] Object containing balances array
+    def spot_balances(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'spotClearinghouseState', user: user })
+    end
+
+    # Get Spot Deploy Auction state for a user
+    # @param user [String] Wallet address
+    # @return [Hash] Spot deploy state
+    def spot_deploy_state(user)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'spotDeployState', user: user })
+    end
+
+    # Get Spot Pair Deploy Auction status
+    # @return [Hash] Auction timing and gas parameters
+    def spot_pair_deploy_auction_status
+      @client.post(Constants::INFO_ENDPOINT, { type: 'spotPairDeployAuctionStatus' })
+    end
+
+    # Get token details by tokenId
+    # @param token_id [String] 34-character hexadecimal token id
+    # @return [Hash] Token details
+    def token_details(token_id)
+      @client.post(Constants::INFO_ENDPOINT, { type: 'tokenDetails', tokenId: token_id })
+    end
   end
+  # rubocop:enable Metrics/ClassLength
 end

data/lib/hyperliquid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hyperliquid
-  VERSION = '0.1.1'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hyperliquid
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - carter2099