ShieldTWAP Logo

Clione – Trading with the Rhythm of the Market

A sophisticated VWAP-Enhanced TWAP algorithm that combines elegant execution with adaptive market flow.

The Sea Angel's Wisdom

In the deep ocean, the Clione, also known as the sea angel, survives not through brute force but through adaptability and elegance. It rides the currents, conserving energy, moving with precision, and striking only when the moment is right.

Inspired by this, Clione is a trading execution tool built to navigate the turbulent seas of financial markets. Instead of rushing headlong, it executes orders with measured rhythm (TWAP) while adapting to the market's natural flow (VWAP).

Every slice of the order is calculated not only by time but also by volume, ensuring that execution feels less like a rigid schedule and more like a trader moving in harmony with the market.

Just as the sea angel thrives in harsh and unpredictable waters, Clione helps traders execute large orders smoothly, discreetly, and intelligently — swimming with the tides rather than fighting against them.

Mathematical Foundation

Core Algorithm

Our VWAP-Enhanced TWAP algorithm dynamically adjusts order volumes based on the price deviation from the Volume Weighted Average Price (VWAP). The mathematical formulation is:

VWAP Calculation (HLC3 Session-based):
VWAP =
Σᵢ HLC3ᵢ × Volumeᵢ
Σᵢ Volumeᵢ
Where:
HLC3ᵢ =
Highᵢ + Lowᵢ + Closeᵢ
3
Dynamic Volume Sizing:
Price Deviation =
VWAP - Current Price
VWAP
Volume Multiplier = 1 + α × Price Deviation
Adjusted Size = Base Size × clamp(Volume Multiplier, min_mult, max_mult)
Parameters:
α (alpha): Sensitivity factor ∈ [0.1, 1.0]
min_mult: Minimum volume multiplier (default: 0.1)
max_mult: Maximum volume multiplier (default: 5.0)

Innovation: When the current price is below VWAP (favorable conditions), the algorithm increases order volume to take advantage of the opportunity. Conversely, when price is above VWAP (unfavorable conditions), it reduces volume to minimize market impact.

Slippage Protection

Our algorithm incorporates real-time orderbook analysis for slippage protection:

Slippage Calculation:
Estimated Fill Price =
Σⱼ Order Level Priceⱼ × Quantityⱼ
Σⱼ Quantityⱼ
Slippage % =
|Estimated Fill Price - Market Price|
Market Price
× 100
Volume Constraint = min(Requested Size, Max Depth × 0.1)
Asset Decimal Compliance:
Rounded Size =
⌊Size × 10^asset_decimals⌋
10^asset_decimals

The algorithm fetches real-time orderbook data from Hyperliquid's API to ensure orders don't exceed available liquidity and stay within acceptable slippage thresholds.

Implementation Architecture

Data Sources

  • Chart Data: Hyperliquid WebSocket + REST API
  • VWAP Calculation: HLC3 Session-based anchoring
  • Orderbook: Real-time depth analysis
  • Market Info: Asset metadata & decimal precision

Execution Engine

  • Order Sizing: VWAP-enhanced dynamic calculation
  • Risk Management: Multi-layer slippage protection
  • Compliance: Hyperliquid decimal requirements
  • Timing: Configurable interval-based execution

🚀 Technical Innovation

Serverless Architecture: We've pioneered a completely client-side trading system that operates without traditional backend infrastructure:

  • No Backend Required: Direct API integration with Hyperliquid
  • Resource Efficient: Eliminates server costs and maintenance
  • Real-time Processing: WebSocket connections for live data
  • Secure Execution: Client-side wallet integration

Current Status & Development Roadmap

✅ Current Features

  • • SPOT Trading (Pioneer Implementation)
  • • VWAP-Enhanced TWAP Algorithm
  • • Slippage Protection by Orderbook Analysis
  • • Instant Volume Calculation
  • • HLC3 VWAP Calculation
  • • Asset Decimal Compliance
  • • Simulation & Backtesting
  • • WebSocket Chart Integration

🔄 In Development

  • • PERP Trading Support
  • • Pair Trading Strategies
  • • Advanced Risk Management
  • • Multi-timeframe VWAP
  • • Multiple VWAP Input Sources
  • • Multi-Wallet Connection & Random Rotation
  • • Random Time Interval & Volume Offsets
  • • Enhanced UI/UX
  • • Performance Optimizations
  • • Additional Market Connectors

🎯 Future Plans

  • • Machine Learning Integration
  • • Cross-Exchange Arbitrage
  • • Portfolio Management Tools
  • • Advanced Analytics Dashboard
  • • Mobile Application
  • • Community Features

⚠️ Current Limitations

VWAP Input Source: Currently locked to HLC3 (High-Low-Close/3) calculation method to ensure compatibility with Hyperliquid's native VWAP implementation.

Upcoming Enhancement: Implementation of configurable VWAP input sources (OHLC4, Close-only, Volume-weighted Close, etc.) is planned for future releases to provide more flexibility for different trading strategies.

Supported Markets

🟢 SPOT Trading (Live)

Currently supporting a few SPOT pairs as pioneer available on Hyperliquid with full VWAP-Enhanced TWAP functionality:

HYPE/USDC
PURR/USDC
ETH/USDC
+ All Hyperliquid SPOT pairs

🟡 PERP Trading (Coming Soon)

Perpetual futures trading with enhanced leverage management and funding rate optimization.

🔵 Pair Trading (Future)

Advanced relative value strategies with correlation-based execution timing.