Overview
This node filters trade data based on a specified recent time range. It processes incoming items containing trade information and outputs only those trades that occurred within the selected timeframe relative to the current time.
Common scenarios for this node include:
- Monitoring recent trading activity by filtering trades from the last few minutes or hours.
- Analyzing short-term market trends by focusing on trades within a specific recent period.
- Integrating with other nodes to trigger actions based on recent trade events.
For example, you could use this node to extract all trades from the last 15 minutes to feed into an alerting system or dashboard showing near real-time trading activity.
Properties
| Name | Meaning |
|---|---|
| Time Range | Select the time range to filter trades. Options: "5 Minutes", "15 Minutes", "1 Hour", "4 Hours", "24 Hours", "7 Days". Each option filters trades from that duration counting backwards from now. |
| Output Options | Configure output behavior when no trades are found: - Include Filter Info: Whether to include a message describing the filter criteria in the output. - Return Empty on No Results: Whether to return an empty array instead of the info message when no trades match. |
Output
The node outputs an array of items where each item corresponds to a trade that falls within the selected time range. Each output item has the following structure:
json: The trade object filtered by the time condition.pairedItem: Metadata linking back to the original input item index.
If no trades are found:
- By default, it returns an array with one item containing a JSON object with a message about no trades found, the filter criteria used, and timestamps.
- Alternatively, if configured, it can return an empty array.
The node does not output binary data.
Dependencies
- No external services or API keys are required.
- The node relies on the input data containing trade objects with a numeric
timeproperty representing a Unix timestamp (seconds since epoch).
Troubleshooting
- Error processing item X: This error occurs if the input data at position X is malformed or missing the expected
timeproperty. Ensure that each input item contains valid trade objects with a propertimefield as a Unix timestamp. - No trades found message: If you receive a message indicating no trades were found, verify that your input data includes trades with timestamps within the selected time range.
- If you want to suppress informational messages when no trades are found, enable the "Return Empty on No Results" option.