Binance icon

Binance

Consume Binance API
Join our community

Actions10

Overview

This node integrates with the Binance API to manage futures orders. It allows users to place buy or sell orders, clear all existing orders, or retrieve open orders for a specified futures trading symbol. This is useful for automating trading strategies, managing positions programmatically, or monitoring active orders on Binance Futures.

Practical examples include:

  • Automatically placing a buy order for a specific futures contract when certain market conditions are met.
  • Clearing all open orders before executing a new trading strategy.
  • Fetching and analyzing open orders to adjust trading parameters dynamically.

Properties

Name Meaning
Side The type of order action: "BUY" to place a buy order, "SELL" to place a sell order, "Clear Orders" to cancel all orders, or "Open Orders" to fetch current open orders.
Symbol Name or ID The futures trading symbol to operate on (e.g., BTCUSDT). Can be selected from a list or specified via an expression.
Quantity The amount of the asset to buy or sell. Required for BUY and SELL actions.
Price The price at which to place the order. Required for BUY and SELL actions.
Reduce Only A boolean flag indicating if the order should only reduce an existing position (true) or not (false). Applies only to BUY and SELL actions.

Output

The node outputs JSON data representing the result of the requested operation:

  • For BUY or SELL operations, the output contains details of the placed order such as order ID, status, executed quantity, and price.
  • For Clear Orders, the output confirms cancellation of all relevant orders.
  • For Open Orders, the output lists all currently open orders for the specified symbol, including their quantities, prices, and statuses.

If binary data were involved (e.g., files), it would be summarized here, but this node deals exclusively with JSON order data.

Dependencies

  • Requires a valid API key credential for Binance with permissions to trade futures.
  • The node depends on the Binance Futures API endpoints for order management.
  • The Symbol Name or ID property uses a dynamic method to load available symbols from Binance.

Troubleshooting

  • Common issues:

    • Invalid API credentials or insufficient permissions can cause authentication errors.
    • Specifying an invalid or unsupported symbol will result in errors from the Binance API.
    • Attempting to place orders with zero or negative quantity/price will fail validation.
    • Using "Reduce Only" incorrectly may cause order rejections if no matching position exists.

  • Error messages:

    • Authentication failures: Check that the API key and secret are correctly configured and have futures trading enabled.
    • Order placement errors: Verify that quantity and price values are positive and conform to Binance's allowed increments.
    • Symbol not found: Ensure the symbol is correct and supported by Binance Futures.

Links and References

Discussion