Actions10
- Spot Actions
- Future Actions
- Custom Actions
Overview
This node interacts with the Binance Spot market to retrieve candlestick (candle) 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 price data.
Typical use cases include:
- Fetching recent candle data for a cryptocurrency pair to visualize price trends.
- Automating trading bots that rely on candle patterns.
- Integrating Binance spot market data into dashboards or reports.
Properties
| Name | Meaning |
|---|---|
| Symbol Name or ID | The trading pair symbol (e.g., BTCUSDT). Choose from a list or specify dynamically via expression. |
| Interval Name or ID | The time interval for each candle (e.g., 1m, 5m, 1h). Choose from a list or specify dynamically. |
| Limit | Maximum number of candle data points to return (minimum 1). |
| Start Time | Optional start timestamp to filter candles from this date/time. |
| End Time | Optional end timestamp to filter candles up to this date/time. |
Output
The node outputs JSON data containing an array of candlestick objects. Each object typically includes:
- Open time
- Open price
- High price
- Low price
- Close price
- Volume
- Close time
- Other relevant candle metadata
This structured data can be used directly in workflows for further processing or visualization.
If binary data output is supported, it would represent raw or processed market data, but this node primarily outputs JSON candle 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 candle data.
- No additional external services are required beyond Binance and n8n's standard environment.
Troubleshooting
- Invalid Symbol or Interval: If the symbol or interval is not recognized, the node may return an error or empty results. Ensure the values are valid and available in Binance.
- API Rate Limits: Binance enforces rate limits; excessive requests may lead to temporary blocking. Use appropriate limits and intervals.
- Time Range Issues: Providing inconsistent or invalid start/end times may cause errors or no data returned. Verify timestamps are correct and logical.
- Authentication Errors: Missing or incorrect API credentials will prevent successful data retrieval. Confirm the API key is valid and has necessary permissions.