Overview
This node interacts with the Kucoin API to perform various order-related operations, specifically focusing here on listing orders. It allows users to retrieve a list of orders filtered by trade type (spot or margin trading) and additional optional parameters such as order status, symbol, side (buy/sell), type (limit, market, etc.), and time range. This is useful for traders or automated workflows that need to monitor or analyze order history or current orders on Kucoin.
Use Case Examples
- A user wants to list all completed spot trading orders for a specific symbol within a certain date range.
- An automated trading system retrieves active margin trading orders filtered by buy side and market type to manage open positions.
Properties
| Name | Meaning |
|---|---|
| Trade Type | The type of trading to list orders for, either Spot Trading (TRADE) or Margin Trading (MARGIN_TRADE). |
| Add Optional Operations | Additional optional filters to refine the list of orders, including status, symbol, side, type, start time, and end time. |
Output
JSON
orderList- Array of orders matching the specified filters, each containing order details as returned by the Kucoin API.
Dependencies
- Kucoin API with API key, secret, and passphrase credentials
Troubleshooting
- Ensure API credentials are correctly configured and have the necessary permissions to access order data.
- Check that the date/time filters (startAt and endAt) are valid timestamps; invalid dates may cause the API request to fail.
- If no orders are returned, verify that the filter parameters are correct and that there are orders matching those criteria.
- Common error messages include authentication errors due to incorrect API keys or signatures, which require verifying the API credentials and their configuration.
Links
- Kucoin API Documentation - Official documentation for Kucoin API endpoints and parameters.