Actions10
- Spot Actions
- Future Actions
- Custom Actions
Overview
This node integrates with the Binance API to fetch candlestick (candle) data for futures trading. It allows users to retrieve historical price data for a specified future symbol over a defined time interval and date range. This is useful for traders, analysts, or automated systems that need to analyze market trends, backtest strategies, or visualize price movements.
Common scenarios include:
- Fetching recent candle data to feed into trading algorithms.
- Visualizing price action over specific intervals.
- Monitoring market conditions for selected futures contracts.
Example: Retrieve the last 50 one-hour candles for the BTCUSDT futures contract between two dates.
Properties
| Name | Meaning |
|---|---|
| Symbol Name or ID | The futures contract symbol to query (e.g., BTCUSDT). Can be selected from a list or specified via expression. |
| Interval Name or ID | The time interval for each candle (e.g., 1m, 5m, 1h). Selectable from predefined options or via expression. |
| Limit | Maximum number of candle data points to return (minimum 1). |
| Start Time | Optional start datetime to filter candles from this timestamp onward. |
| End Time | Optional end datetime to filter candles up to this timestamp. |
Output
The node outputs JSON data containing an array of candlestick objects. Each object typically includes fields such as open time, open price, high price, low price, close price, volume, and close time, representing one candle in the specified interval.
If binary data output is supported, it would represent raw or processed market data, but based on the provided code and properties, the output is JSON-formatted candlestick data.
Dependencies
- Requires an API key credential for authenticating with the Binance API.
- The node depends on the Binance API service being accessible.
- No additional environment variables are indicated beyond the required API authentication.
Troubleshooting
- Invalid Symbol or Interval: If the symbol or interval is not recognized by Binance, the node may return an error or empty results. Ensure the symbol and interval values are valid and available.
- API Authentication Errors: Missing or incorrect API credentials will cause authentication failures. Verify that the API key is correctly configured.
- Rate Limits: Binance enforces rate limits; excessive requests may result in temporary blocking. Implement appropriate delays or limit request frequency.
- Date Range Issues: Providing invalid or inconsistent start and end times may lead to no data returned or errors. Ensure startTime is before endTime.