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. This is useful for traders and analysts who want to analyze market trends, perform technical analysis, or build automated trading strategies based on historical candle data.
Typical use cases include:
- Fetching recent candlestick data for a specific futures contract.
- Analyzing price movements within a custom time range.
- Limiting the number of returned candles to optimize performance or focus on recent data.
Properties
| Name | Meaning |
|---|---|
| Symbol Name or ID | The futures symbol to query candlestick data for. Users can select from a list or specify an ID via expression. |
| Interval Name or ID | The time interval for each candlestick (e.g., 1m, 5m, 1h). Selectable from a list or specified by expression. |
| Limit | Maximum number of candlestick records to return. Must be at least 1. |
| Start Time | Optional start datetime to filter candlesticks from this point onward. |
| End Time | Optional end datetime to filter candlesticks up to this point. |
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 requested interval.
If binary data output is supported, it would represent raw or processed data related to the candlestick information, but this node primarily outputs structured JSON data.
Dependencies
- Requires access to the Binance API for futures data.
- Needs an API key credential configured in n8n to authenticate requests.
- Uses internal methods to load available symbols and intervals dynamically.
Troubleshooting
- Invalid Symbol or Interval: If the selected symbol or interval is not recognized, the node may fail. Ensure the symbol and interval exist and are correctly spelled or selected.
- API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key is correctly set up in n8n.
- Rate Limits: Binance enforces rate limits; excessive requests may result in temporary blocking. Use the "Limit" property wisely and avoid rapid repeated calls.
- Date Range Issues: Providing inconsistent or invalid start and end times may lead to empty results or errors. Ensure start time is before end time and both are valid dates.