How CLOBr Works
Understand the technology behind CLOBr and how it aggregates and visualizes liquidity data from multiple sources.
The Technology Behind CLOBr
CLOBr functions as a sophisticated data aggregation and visualization platform that transforms complex on-chain liquidity data into actionable trading insights. This section explains the technical infrastructure, data collection process, and visualization methodology that powers CLOBr.
Data Collection Process
On-demand (when a user clicks "Refresh Data"), CLOBr retrieves the relevant markets for the target token on the Solana blockchain, queries them for their current state, collecting data through a combination of RPC node connections and direct API integrations with various protocols.
Data Sources and Collection Methods
Concentrated Liquidity Positions
- Raydium CLAMMs: CLOBr fetches the active concentrated liquidity positions and their respective upper and lower bounds and liquidity amounts
- Orca Whirlpools: Position data is collected from all active Whirlpool contracts
- Meteora DLMMs: Each DLMM pool's bins and token amounts are fetched
- Each position's token amounts, price ranges, and USD values are recorded and standardized at 1% price change intervals, anchored at the current price
Jupiter Limit (Trigger) Orders
- Active limit orders are queried from Jupiter's API
- Order data includes the asset pair, direction (buy/sell), size, limit price, and status
- Only open orders that haven't been filled or canceled are included in the analysis
- The remaining order balance is converted to standardized USD value for consistent visualization
Jupiter DCA (Recurring) Orders
- DCA (Dollar-Cost Averaging) orders are retrieved from Jupiter's DCA program
- CLOBr calculates the price impact for the next 24 hours by analyzing the order's total size, remaining amount, and execution schedule
- The price impact is converted to standardized USD value for consistent visualization
Data Refresh Frequency
CLOBr's data collection operates on-demand:
- Initial Token Analysis: All market data is fetched and processed when a user first clicks "Analyze Now"
- On-demand updates: All data is re-fetched and processed when a user clicks "Refresh Data"
These on-demand updates ensure that CLOBr provides users with 100% up-to-date information to support trading decisions.
Data Processing Pipeline
Once collected, the raw data undergoes several processing steps to transform it into useful, visualized information:
| Processing Stage | Description |
|---|---|
| Normalization | All data is converted to a standardized format with consistent units (USD) for all pools and pairs |
| Price Bucketing | Liquidity is organized into 1% price-change buckets relative to the current price |
| Aggregation | Liquidity from all sources is combined and summed at each price level, from -90% to +1000% price change |
| Direction Analysis | Each position is analyzed to determine if it represents support (below current price) or resistance (above current price) |
| Pair Exposure Calculation | The system calculates the underlying token composition of each liquidity pool, so users can gauge the relative exposure of the token to others |
Concentration Bucketing Methodology
A key aspect of CLOBr's processing is how it buckets liquidity into meaningful price intervals:
1% Bucket System
CLOBr uses a 1% price bucket system, meaning liquidity is grouped into bins that each represent a 1% price movement from the current price. This approach balances granularity with meaningful visualization.
- A position spanning multiple 1% buckets is proportionally distributed across them
- For example, if a position has $10,000 of liquidity from -5% to +5% of current price, $1,000 would be allocated to each 1% bucket within that range
- This bucketing system allows traders to quickly see how much liquidity exists at various price levels
Visualization Methodology
CLOBr's frontend takes the processed data and renders it as an intuitive depth chart:
CLOBr depth chart components
Key Visualization Elements
- Horizontal axis (bar length): Represents amount of $USD (or SOL, if toggled) at each price level
- Vertical axis: The price levels for the token, in $USD (or SOL, if toggled). Each bar is a 1% price change from the bar above and below.
- Gray bars (below current price): Buy liquidity/support. Sells get absorbed by this liquidity. Bigger bars indicate more support, making it harder for the price to break below.
- Orange bars (above current price): Sell liquidity/resistance. Buys get absorbed by this liquidity. Bigger bars indicate more resistance, making it harder for the price to break above.
- Constant Product bars: The bars that represent the constant product of the liquidity pools. This liquidity behaves predictably at all price levels and does not cause buy and sell "walls."
Color Coding and Visual Indicators
CLOBr uses a consistent visual language to communicate different types of information:
- Orange/gray bars: Indicating resistance (orange) and support (gray) liquidity
- Bar length: The length of the bar indicates the amount of liquidity (normalized to $USD) at that price level.
- Tooltips: Provide detailed information about specific price buckets when hovered
Visible Range Control Slider
The slider allows you to control the range of prices that are visible in the charts, from -90% to +1000% of the current price. The range buttons are shortcuts to quickly view popular ranges and affect all the charts on the page.
CLOBr range control slider
From Raw Data to Actionable Insights
The power of CLOBr lies in its ability to transform complex, fragmented liquidity data into clear, actionable trading insights:
- Collection: CLOBr continuously gathers raw data from multiple sources
- Processing: This data is normalized, bucketed, and aggregated
- Visualization: The processed data is rendered as an intuitive depth chart
- Analysis: Traders can identify support/resistance levels and make informed decisions
This transformation process is what makes CLOBr so valuable for traders. Instead of parsing complex on-chain data manually, you get a clear visualization that reveals market structure and helps you make better trading decisions.
In the next section, we'll explore CLOBr's key features and explain how each one contributes to your trading success.