Get Price Change Info

Retrieves 24-hour price change statistics for a trading pair, including price movements, volume, and trading activity.

Common Properties

• Name - The custom name of the node.
• Color - The custom color of the node.
• Delay Before (sec) - Waits in seconds before executing the node.
• Delay After (sec) - Waits in seconds after executing node.
• Continue On Error - Automation will continue regardless of any error. The default value is false.

info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs

• Client Id - The unique identifier from the Connect node (optional if using direct credentials).
• Currency - The trading pair symbol (e.g., BTCUSDT, ETHUSDT, BNBUSDT).

Options

• Api Key - (Optional) Binance API key credential. Use if not providing Client Id.
• Secret Key - (Optional) Binance API secret key credential. Use if not providing Client Id.

Output

• Result - An object containing comprehensive 24-hour price change statistics.

How It Works

The Get Price Change Info node queries Binance for 24-hour trading statistics of a specific pair.

When executed, the node:

1. Retrieves the Binance client (from Client Id or creates one from credentials)
2. Validates the Currency (trading pair) input
3. Queries Binance's 24-hour ticker statistics endpoint
4. Returns detailed price change and volume information

Requirements

• Either a Client Id from Connect node OR API credentials in options
• Valid trading pair symbol that exists on Binance
• Appropriate API permissions (reading enabled)

Error Handling

The node will return specific errors in the following cases:

• ErrInternal - Failed to retrieve input values
• ErrInvalidArg - Empty or invalid Currency
• ErrListPriceChange - Failed to retrieve statistics from Binance
• ErrSetResult - Failed to set the output result

Usage Notes

• All statistics cover the previous 24 hours (rolling window)
• Price data is updated in real-time
• Volume is calculated in both base and quote assets
• Includes high/low prices and price change percentages
• Useful for market analysis and trend identification

Price Change Statistics

The result object includes:

{
  "symbol": "BTCUSDT",
  "priceChange": "1250.50",
  "priceChangePercent": "2.56",
  "weightedAvgPrice": "49800.25",
  "prevClosePrice": "48750.00",
  "lastPrice": "50000.50",
  "lastQty": "0.001",
  "bidPrice": "50000.00",
  "bidQty": "1.5",
  "askPrice": "50001.00",
  "askQty": "2.3",
  "openPrice": "48750.00",
  "highPrice": "51000.00",
  "lowPrice": "48000.00",
  "volume": "15000.50",
  "quoteVolume": "747525000.00",
  "openTime": 1640000000000,
  "closeTime": 1640086400000,
  "firstId": 123456789,
  "lastId": 123556789,
  "count": 100000
}

Key Statistics Explained

Price Metrics:

• priceChange - Absolute price change in 24h
• priceChangePercent - Percentage change in 24h
• openPrice - Price 24 hours ago
• lastPrice - Most recent trade price
• highPrice - Highest price in 24h
• lowPrice - Lowest price in 24h
• weightedAvgPrice - Volume-weighted average price

Order Book:

• bidPrice - Highest current buy order
• askPrice - Lowest current sell order
• bidQty - Quantity at best bid
• askQty - Quantity at best ask

Volume:

• volume - Total traded volume in base asset
• quoteVolume - Total traded volume in quote asset

Trading Activity:

• count - Number of trades in 24h
• openTime - Start of 24h window (milliseconds)
• closeTime - End of 24h window (milliseconds)

Example: Market Overview

Scenario: Get comprehensive BTC market statistics

Inputs:

• Client Id: (from Connect node)
• Currency: BTCUSDT

Output: Complete 24-hour statistics including price changes, volume, and trading activity.

Example: Volatility Check

[Connect]
    |
    v
[Get Price Change Info: BTCUSDT]
    |
    v
[Calculate: price_range = result.highPrice - result.lowPrice]
[Calculate: volatility = (price_range / result.openPrice) * 100]
    |
    v
[If: volatility > 5]
    |
    +---> [Alert: "High volatility detected: " + volatility + "%"]
    |
    +---> [Log: "Normal market conditions"]
    v
[Disconnect]

Example: Trend Identification

[Get Price Change Info: BTCUSDT]
    |
    v
[Extract: change_percent = parseFloat(result.priceChangePercent)]
    |
    v
[If: change_percent > 3]
    |
    +---> [Alert: "Strong uptrend: +" + change_percent + "%"]
    |
[Else If: change_percent < -3]
    |
    +---> [Alert: "Strong downtrend: " + change_percent + "%"]
    |
    +---> [Log: "Sideways market"]

Example: Volume Analysis

[Get Price Change Info: BTCUSDT]
    |
    v
[Store: current_volume = result.volume]
    |
    v
[Compare: with average_daily_volume]
    |
    v
[If: current_volume > average_daily_volume * 1.5]
    |
    v
[Alert: "Unusual volume detected - potential breakout"]

Example: Spread Analysis

[Get Price Change Info: BTCUSDT]
    |
    v
[Calculate: spread = result.askPrice - result.bidPrice]
[Calculate: spread_percent = (spread / result.lastPrice) * 100]
    |
    v
[If: spread_percent > 0.1]
    |
    v
[Alert: "Wide spread - low liquidity warning"]

Market Analysis Calculations

// Price change analysis
const priceChange = parseFloat(result.priceChange);
const changePercent = parseFloat(result.priceChangePercent);
const isUptrend = changePercent > 0;

// Volatility calculation
const priceRange = parseFloat(result.highPrice) - parseFloat(result.lowPrice);
const volatility = (priceRange / parseFloat(result.openPrice)) * 100;

// Spread analysis
const spread = parseFloat(result.askPrice) - parseFloat(result.bidPrice);
const spreadPercent = (spread / parseFloat(result.lastPrice)) * 100;

// Volume analysis
const volumeUSD = parseFloat(result.quoteVolume);
const averageTradeSize = volumeUSD / result.count;

Use Cases

Market Monitoring:

• Track 24-hour price movements
• Identify trends and momentum
• Monitor trading volume

Trading Decisions:

• Assess market volatility before trading
• Check liquidity via spread and volume
• Identify entry/exit opportunities

Risk Management:

• Avoid trading during high volatility
• Monitor for unusual market activity
• Set appropriate stop-loss distances

Reporting:

• Generate daily market summaries
• Track performance metrics
• Analyze market conditions

Trading Tips

• High Volume + Price Change: Strong trend confirmation
• Low Volume + Price Change: Weak trend, potential reversal
• Wide Spread: Low liquidity, higher slippage risk
• High Volatility: Larger price swings, adjust risk accordingly
• 24h High/Low: Key support/resistance levels

Best Practices

• Check price change percentage to identify strong trends
• Monitor volume for trade confirmation
• Use high/low prices to set stop-loss and take-profit levels
• Analyze spread before placing large orders
• Compare current volume with historical averages
• Consider volatility when setting order prices
• Use weighted average price for fair value reference
• Check trading count to assess market activity

Interpreting Price Changes

Strong Uptrend:

• priceChangePercent > 5%
• High volume
• Price near 24h high

Strong Downtrend:

• priceChangePercent < -5%
• High volume
• Price near 24h low

Sideways/Consolidation:

• priceChangePercent between -2% and 2%
• Moderate volume
• Price in middle of 24h range

Volatile Market:

• Large difference between high and low
• Rapid price changes
• Potentially risky trading conditions

Combining Indicators

Get Price Change Info
    |
    +---> Trend: priceChangePercent
    +---> Momentum: volume comparison
    +---> Volatility: high - low range
    +---> Liquidity: bid-ask spread
    +---> Support/Resistance: 24h high/low

Common Patterns

Breakout Detection:

If lastPrice > highPrice * 0.99:
    Alert: "Approaching 24h high - potential breakout"

Support Testing:

If lastPrice < lowPrice * 1.01:
    Alert: "Testing 24h low - potential bounce or breakdown"

Volume Spike:

If volume > average_volume * 2:
    Alert: "Volume spike detected - increased activity"