Actions10
- Future Actions
- Spot Actions
- Custom Actions
Overview
This node interacts with the Binance Spot market API to retrieve candlestick (kline) data for a specified trading symbol. It is useful for users who want to analyze historical price movements, perform technical analysis, or build trading strategies based on time-series market data.
Typical use cases include:
- Fetching recent price candles for a cryptocurrency pair to visualize price trends.
- Collecting historical candle data for backtesting trading algorithms.
- Monitoring market intervals to trigger alerts or automated trades.
For example, a user might request 50 one-minute interval candles for the BTC/USDT trading pair between two specific timestamps to analyze short-term price fluctuations.
Properties
| Name | Meaning |
|---|---|
| Symbol Name or ID | The trading pair symbol (e.g., BTCUSDT) to fetch candle data for. Can be selected from a list or set via expression. |
| Interval Name or ID | The time interval for each candle (e.g., 1m, 5m, 1h). Selectable from predefined options or set via expression. |
| Limit | Maximum number of candle data points to return. Must be at least 1. |
| Start Time | Optional start timestamp to filter candles from this time onward. |
| End Time | Optional end timestamp to filter candles up to this time. |
Output
The node outputs an array of JSON objects representing candlestick data. Each object typically contains fields such as:
- Open time
- Open price
- High price
- Low price
- Close price
- Volume
- Close time
- Number of trades
This structured data allows downstream nodes or workflows to process and analyze market price movements over the specified interval.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Binance API.
- The node depends on the Binance Spot market API endpoints for fetching candlestick data.
- No additional external services are required beyond Binance's API.
Troubleshooting
- Invalid Symbol or Interval: If the symbol or interval is incorrect or unsupported, the API may return errors or empty results. Verify that the symbol exists on Binance and the interval is valid.
- API Rate Limits: Binance enforces rate limits; excessive requests may result in temporary blocking. Implement appropriate delays or error handling.
- Time Range Issues: Providing inconsistent or invalid start/end times may cause no data to be returned. Ensure start time is before end time and both are within available data range.
- Authentication Errors: Missing or invalid API credentials will prevent successful API calls. Confirm that the API key is correctly configured in n8n.