Skip to main content

Market Data Commands

Query real-time market data across all supported DEXs using natural language. The AI agent fetches prices, order books, funding rates, and market statistics to help you make informed trading decisions.

Price Queries​

Current Price​

Get the latest price for any trading pair:

Commands:

  • What's the BTC price?
  • Show me ETH price on Hyperliquid
  • Get current SOL price
  • BTC price on Aster

AI Response Example:

BTC current price on Hyperliquid:
- Price: $43,250.00
- 24h Change: +2.5% (+$1,055)
- 24h High: $43,800.00
- 24h Low: $41,950.00
- Last Updated: 2024-01-09 14:30:00 UTC

Multiple Assets​

Query multiple prices at once:

Commands:

  • Show me prices for BTC, ETH, and SOL
  • What are the current prices on Hyperliquid?
  • Get prices for all my positions

Historical Prices​

Check price at specific times:

Commands:

  • What was BTC price 1 hour ago?
  • Show me ETH price history for today
  • BTC price 24 hours ago

Order Book Data​

Order Book Depth​

View current buy and sell orders:

Commands:

  • Show me BTC order book
  • Get ETH order book on Hyperliquid
  • What's the order book depth for SOL?

AI Response Example:

BTC Order Book on Hyperliquid:

Top 5 Bids (Buy Orders):
1. $43,245.00 - 2.5 BTC
2. $43,240.00 - 1.8 BTC
3. $43,235.00 - 3.2 BTC
4. $43,230.00 - 1.5 BTC
5. $43,225.00 - 2.1 BTC

Top 5 Asks (Sell Orders):
1. $43,255.00 - 1.9 BTC
2. $43,260.00 - 2.3 BTC
3. $43,265.00 - 1.7 BTC
4. $43,270.00 - 2.8 BTC
5. $43,275.00 - 1.4 BTC

Spread: $10.00 (0.023%)

Liquidity Analysis​

Understand market depth:

Commands:

  • How much liquidity is there for BTC?
  • What's the spread for ETH?
  • Show me bid-ask spread for SOL

Funding Rates​

Current Funding Rate​

Check perpetual funding rates:

Commands:

  • What's the BTC funding rate?
  • Show me ETH funding rate on Hyperliquid
  • Get funding rates for all my positions

AI Response Example:

BTC Funding Rate on Hyperliquid:
- Current Rate: 0.0125% (8h)
- Annualized: ~11.4%
- Next Funding: 2024-01-09 16:00:00 UTC (1h 30m)
- Trend: Positive (long positions pay short)

This indicates bullish sentiment in the market.

Funding Rate History​

Track funding rate trends:

Commands:

  • Show me BTC funding rate history
  • What was ETH funding rate yesterday?
  • Funding rate trend for SOL

Market Statistics​

24-Hour Statistics​

Get comprehensive market stats:

Commands:

  • Show me BTC 24h stats
  • What's the trading volume for ETH?
  • Get market statistics for SOL on Hyperliquid

AI Response Example:

BTC 24-Hour Statistics on Hyperliquid:
- Current Price: $43,250.00
- 24h Change: +2.5% (+$1,055)
- 24h High: $43,800.00
- 24h Low: $41,950.00
- 24h Volume: $2.4B
- Open Interest: $1.8B
- Funding Rate: 0.0125%

Open Interest​

Check total open positions:

Commands:

  • What's the open interest for BTC?
  • Show me ETH open interest on Hyperliquid
  • Get open interest across all DEXs

Trading Volume​

Query volume data:

Commands:

  • What's the BTC trading volume?
  • Show me 24h volume for ETH
  • Compare volume across DEXs for BTC

Available Markets​

List Trading Pairs​

Discover tradable assets:

Commands:

  • What markets can I trade?
  • Show me all available pairs on Hyperliquid
  • What assets are available on Aster?
  • List all perpetual markets

AI Response Example:

Available Perpetual Markets on Hyperliquid:

Major Pairs:
- BTC-PERP, ETH-PERP, SOL-PERP
- AVAX-PERP, MATIC-PERP, ARB-PERP

Altcoins:
- DOGE-PERP, SHIB-PERP, PEPE-PERP
- WIF-PERP, BONK-PERP

DeFi Tokens:
- UNI-PERP, AAVE-PERP, MKR-PERP

Total: 45+ perpetual markets

Spot Markets​

Query spot trading pairs:

Commands:

  • What spot markets are available?
  • Show me spot pairs on Hyperliquid
  • Can I trade HYPE tokens?

Market Comparisons​

Cross-DEX Price Comparison​

Compare prices across exchanges:

Commands:

  • Compare BTC price across all DEXs
  • What's the price difference for ETH between Hyperliquid and Aster?
  • Show me arbitrage opportunities

AI Response Example:

BTC Price Comparison:

Hyperliquid: $43,250.00
Aster: $43,265.00 (+$15, +0.035%)
Lighter: $43,248.00 (-$2, -0.005%)

Best Price: Lighter ($43,248.00)
Worst Price: Aster ($43,265.00)
Max Spread: $17.00 (0.039%)

Funding Rate Comparison​

Compare funding rates:

Commands:

  • Compare BTC funding rates across DEXs
  • Which DEX has the best ETH funding rate?
  • Show me funding rate differences

Liquidity Comparison​

Compare market depth:

Commands:

  • Which DEX has better liquidity for BTC?
  • Compare order book depth across DEXs
  • Where should I trade large orders?

Analyze price movements:

Commands:

  • Is BTC trending up or down?
  • Show me ETH price trend
  • What's the market sentiment for SOL?

AI Response Example:

BTC Market Trend Analysis:

Short-term (1h): Bullish ↗
- Price: +1.2% ($43,250)
- Volume: Increasing
- Momentum: Strong

Medium-term (24h): Bullish ↗
- Price: +2.5% ($43,250)
- High: $43,800
- Low: $41,950

Indicators:
- Funding Rate: Positive (0.0125%)
- Open Interest: Growing (+3.2%)
- Volume: Above average

Overall Sentiment: Bullish

Track trading activity:

Commands:

  • Is BTC volume increasing?
  • Show me volume trend for ETH
  • What's the volume pattern for SOL?

Real-Time Updates​

Live Price Monitoring​

Get continuous updates:

Commands:

  • Monitor BTC price
  • Alert me when ETH reaches $2,500
  • Track SOL price movements
Real-Time Data

Market data is fetched in real-time from each DEX. Prices update every few seconds, ensuring you have the latest information for trading decisions.

Market Data Best Practices​

1. Check Before Trading​

Always verify current price before placing orders:

You: What's the BTC price?
AI: [Shows current price]

You: Long 0.1 BTC with 5x leverage
AI: [Uses latest price for order calculation]

2. Compare Across DEXs​

Find the best execution price:

You: Compare BTC price across all DEXs
AI: [Shows price comparison]

You: Buy on Lighter (best price)
AI: [Executes on Lighter]

3. Monitor Funding Rates​

Understand funding costs:

You: What's the BTC funding rate on Hyperliquid?
AI: [Shows funding rate and cost]

You: [Decide if position is worth holding]

4. Check Liquidity​

Ensure sufficient depth for large orders:

You: Show me BTC order book
AI: [Shows liquidity depth]

You: [Assess slippage for order size]

5. Track Open Interest​

Gauge market participation:

You: What's the BTC open interest?
AI: [Shows OI and trend]

You: [Understand market positioning]

Understanding Market Data​

Price Components​

Mark Price: Current trading price used for PnL calculation

Index Price: Weighted average from spot exchanges

Last Price: Most recent trade execution price

Funding Rate Mechanics​

Positive Rate: Long positions pay short positions (bullish sentiment)

Negative Rate: Short positions pay long positions (bearish sentiment)

Payment Frequency: Every 8 hours (varies by DEX)

Order Book Interpretation​

Tight Spread: High liquidity, low slippage

Wide Spread: Low liquidity, higher slippage

Large Bids: Strong buy support

Large Asks: Strong sell resistance

Limitations​

Data Availability​

  • Market data depends on DEX API availability
  • Some DEXs may have delayed data feeds
  • Historical data may be limited

Accuracy​

  • Prices are fetched in real-time but may have slight delays
  • Order book depth shows snapshot at query time
  • Funding rates update at specific intervals

DEX-Specific Features​

  • Not all DEXs provide the same data granularity
  • Some statistics may be unavailable on certain DEXs
  • Data format varies by exchange

Next Steps​

Master market data queries and move on to trading:

Support​