Get Taker Buy Sell Volume Data

Feature Overview OpenAPI JSON Spec Get taker buy sell volume data for a specific trading pair symbol with optional time range filtering.

Main Use Cases

• Market Sentiment Analysis: Track the ratio of taker buy to sell volume over time
• Trading Strategy: Use buy/sell volume ratio as a market sentiment indicator
• Risk Management: Monitor extreme buying or selling pressure in the market
• Technical Analysis: Combine with price action for comprehensive analysis

Query Parameters & Logic

Required Parameters:

• symbol: Trading pair symbol (e.g., BTCUSDT)
• period: Data period (currently only supports 1d)

Optional Parameters:

• start_time: Start timestamp (Unix seconds) - if not provided, returns recent data
• end_time: End timestamp (Unix seconds) - if not provided, returns up to current time
• limit: Maximum number of results to return (1-500, default: 30)

Supported Periods:

• 1d: 1-day intervals

Validation Rules:

• Symbol is required and must be a valid trading pair
• If both start_time and end_time are provided, start_time must be before end_time
• Period must be 1d
• Limit range: 1-500, default is 30

Response Data Structure

• data ([]TakerBuySellVolumeData): Array of taker buy sell volume data points (latest first, reverse chronological order)
• count (int32): Actual number of data points returned (0-1000)

TakerBuySellVolumeData fields:

• buy_vol (string): Taker buy volume in string format
• sell_vol (string): Taker sell volume in string format
• buy_sell_ratio (string): Buy/Sell ratio in string format (e.g., “1.5” means buy volume is 1.5x sell volume)
• timestamp (string): Unix timestamp in seconds as string (e.g., “1763978100”)

Data Interpretation:

• buySellRatio > 1.0: More buying pressure (bullish sentiment)
• buySellRatio = 1.0: Equal buy and sell volume (neutral)
• buySellRatio < 1.0: More selling pressure (bearish sentiment)

Usage Examples

1. Get latest 5 data points: ?symbol=BTCUSDT&period=1d&limit=5
2. Get latest 100 data points: ?symbol=BTCUSDT&period=1d&limit=100
3. Get data for specific time range: ?symbol=BTCUSDT&start_time=1733270400&end_time=1733356800&period=1d&limit=200
4. Get maximum data points: ?symbol=ETHUSDT&period=1d&limit=500

Important Notes

• If start_time and end_time are not provided, returns the most recent data
• Results are ordered by timestamp in ascending order
• Higher buy/sell ratio indicates more bullish sentiment
• Data is provided in 1-day intervals