Get Long Short Ratio Data

Feature Overview OpenAPI JSON Spec Get long short ratio data for a specific trading pair symbol with time range filtering.

Main Use Cases

• Market Sentiment Analysis: Track the ratio of long to short positions over time
• Trading Strategy: Use long/short ratio as a contrarian or confirmation indicator
• Risk Management: Monitor extreme positioning in the market
• Technical Analysis: Combine with price action for comprehensive analysis

Query Parameters & Logic

Required Parameters:

• symbol: Trading pair symbol (e.g., BTCUSDT)
• start_time: Start timestamp (Unix seconds)
• end_time: End timestamp (Unix seconds)

Optional Parameters:

• limit: Maximum number of results to return (1-1000, default: 30)
• exchange: Exchange name (only “binance” supported, default: binance)
• interval: Time interval (only “1d” supported, default: 1d)

Supported Intervals:

• 1d: 1-day intervals (default)

Validation Rules:

• Symbol is required and must be a valid trading pair
• start_time must be before end_time
• Limit defaults to 30 if not provided, max 1000
• Exchange defaults to “binance” if not provided
• Interval defaults to “1d” if not provided

Response Data Structure

• data ([]LongShortRatioData): Array of long short ratio data points (latest first, reverse chronological order)
• count (int32): Actual number of data points returned (0-1000)
• latest_time (string): Timestamp of the most recent data point (Unix seconds as string)

LongShortRatioData fields:

• symbol (string): Trading pair symbol (e.g., “BTCUSDT”)
• long_short_ratio (string): Long/Short ratio in string format (e.g., “2.2798” means 2.28:1 long:short)
• long_account_ratio (number): Long account proportion (e.g., 0.65 means 65% of accounts are long; 0 when source data is missing)
• short_account_ratio (number): Short account proportion (e.g., 0.35 means 35% of accounts are short; 0 when source data is missing)
• timestamp (string): Unix timestamp in seconds as string (e.g., “1763978100”)

Data Interpretation:

• longShortRatio > 1.0: More accounts are long (bullish sentiment)
• longShortRatio = 1.0: Equal long and short positions (neutral)
• longShortRatio < 1.0: More accounts are short (bearish sentiment)

Usage Examples

1. Minimal request (uses defaults): ?symbol=BTCUSDT&start_time=1733270400&end_time=1733356800
2. With custom limit: ?symbol=BTCUSDT&start_time=1733270400&end_time=1733356800&limit=100
3. Full parameters: ?symbol=BTCUSDT&start_time=1733270400&end_time=1733356800&limit=100&interval=5min&exchange=binance

Important Notes

• All required parameters must be provided
• Results are ordered by timestamp in ascending order
• Higher long/short ratio indicates more bullish sentiment
• Data is provided in 1-day intervals (1d)