Skip to main content
POST
/
info
Retrieve recent trades
curl --request POST \
  --url https://api.hyperliquid.xyz/info \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "recentTrades",
  "coin": "BTC"
}
'
[
  {
    "px": "<string>",
    "sz": "<string>",
    "side": "A",
    "time": 123,
    "tid": 123
  }
]
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet.
The info endpoint with type: "recentTrades" retrieves the most recent public trades for a specific asset on the Hyperliquid exchange. This endpoint provides real-time trade data including execution prices, quantities, and timing information, making it essential for market analysis, price discovery, and trading decision-making.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

​
Request body

  • type (string, required) — The request type. Must be "recentTrades" to retrieve recent trades.
  • coin (string, required) — Asset identifier (simple names like “BTC”, “ETH” for perpetuals; spot format like “@107” for spot trades).

​
Response

The response is an array of recent trade objects, each representing a completed trade execution:

​
Trade data structure

Each trade object contains the following fields: Core trade data:
  • px — Trade price as a string for precision
  • sz — Trade size (quantity traded) as a string
  • side — Trade side: “A” for Ask/Sell, “B” for Bid/Buy
  • time — Trade timestamp in milliseconds
  • tid — Unique trade ID

​
Data characteristics

Trade ordering:
  • Trades are returned in reverse chronological order (most recent first)
  • Each trade represents a completed market transaction
  • Trade IDs are unique and sequential
Price and size precision:
  • All prices and sizes are returned as strings to maintain precision
  • Precision depends on the asset’s tick size and lot size requirements
  • No rounding or truncation is applied to the original trade data

​
Trade interpretation

Trade sides:
  • "B" (Bid/Buy) — Trade executed by a buyer (market buy or aggressive buy)
  • "A" (Ask/Sell) — Trade executed by a seller (market sell or aggressive sell)
  • Side indicates the direction of the aggressive order that initiated the trade
Market activity indicators:
  • High frequency of trades indicates active market conditions
  • Large trade sizes may indicate institutional activity
  • Price progression shows market direction and momentum

​
Asset identification

Perpetual contracts:
  • Use simple asset names: “BTC”, “ETH”, “AVAX”, “SOL”
  • Represent standard perpetual futures contracts
Spot markets:
  • Use indexed format: “@107”, “@1”, etc.
  • Index corresponds to the spot pair position in the universe
  • Some assets may have remapped names in user interfaces

​
Market data analysis

​
Price discovery

Recent price action:
  • Latest trades show current market pricing
  • Trade sequence reveals price movement direction
  • Price clustering indicates support/resistance levels
Volume analysis:
  • Trade sizes indicate market participation levels
  • Consistent large trades may indicate institutional activity
  • Volume distribution shows market depth and liquidity

​
Market sentiment

Buy/sell pressure:
  • Predominance of “B” trades indicates buying pressure
  • Predominance of “A” trades indicates selling pressure
  • Balance of sides shows market equilibrium
Trade frequency:
  • High trade frequency indicates active market conditions
  • Low frequency may indicate consolidation or low liquidity
  • Irregular patterns may indicate news or event-driven activity

​
Real-time applications

​
Trading signals

Momentum indicators:
  • Consecutive trades in one direction indicate momentum
  • Price acceleration shows strengthening trends
  • Volume spikes may precede significant moves
Liquidity assessment:
  • Trade frequency indicates market liquidity
  • Size distribution shows depth of market participation
  • Consistent execution suggests stable liquidity conditions

​
Example request

Shell
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"type": "recentTrades", "coin": "BTC"}' \
  https://api.hyperliquid.xyz/info

​
Use cases

The info endpoint with type: "recentTrades" is essential for applications that need to:
  • Real-time price feeds: Display current market prices and recent trading activity
  • Market analysis: Analyze recent trading patterns, volume, and price movements
  • Trading algorithms: Make trading decisions based on recent market activity and momentum
  • Price discovery: Understand current market pricing and recent execution levels
  • Liquidity assessment: Evaluate market liquidity and trading activity levels
  • Market surveillance: Monitor trading activity for unusual patterns or market manipulation
  • Trading interfaces: Display recent trades in trading applications and market data feeds
  • Technical analysis: Analyze short-term price action and trading volume patterns
  • Market making: Assess recent trading activity to optimize bid-ask spreads and positioning
  • Risk management: Monitor recent market activity for risk assessment and position management
  • Arbitrage detection: Identify price discrepancies and trading opportunities across markets
  • Market research: Study trading behavior, market microstructure, and execution patterns
  • Performance benchmarking: Compare execution prices against recent market trades
  • Compliance monitoring: Track trading activity for regulatory compliance and reporting
  • News impact analysis: Assess market reaction to news events through trading activity
  • Volatility analysis: Study price volatility and trading intensity patterns
  • Market timing: Identify optimal entry and exit points based on recent trading activity
  • Quantitative analysis: Perform statistical analysis on recent trading data
  • Academic research: Study market dynamics, price formation, and trading behavior
  • Customer analytics: Analyze customer trading patterns relative to market activity
This endpoint provides essential real-time market data, enabling comprehensive market analysis and trading decision-making on the Hyperliquid platform.

Body

application/json
​
type
enum<string>
default:recentTrades
required

The request type. Must be 'recentTrades' to retrieve recent trades.

Available options:
recentTrades
​
coin
string
default:BTC
required

Asset identifier (simple names like 'BTC', 'ETH' for perpetuals; spot format like '@107' for spot trades)

Response

200 - application/json

Successful response with recent trades data

​
px
string
required

Trade price as a string for precision

​
sz
string
required

Trade size (quantity traded)

​
side
enum<string>
required

Trade side: 'A' for Ask/Sell, 'B' for Bid/Buy

Available options:
A,
B
​
time
integer<int64>
required

Trade timestamp in milliseconds

​
tid
integer<int64>
required

Unique trade ID

Last modified on October 19, 2025