Binance icon

Binance

Consume Binance API

Actions10

Overview

This node integrates with the Binance API, specifically providing functionality related to futures trading. The "Future" resource with the "Position" operation allows users to retrieve information about their current futures positions on Binance. This is useful for traders who want to programmatically monitor their open positions, including details such as symbol, position size, entry price, and unrealized profit/loss.

Practical examples include:

  • Automatically fetching open futures positions to display in a custom dashboard.
  • Triggering workflows based on position changes or specific conditions (e.g., closing a position if loss exceeds a threshold).
  • Integrating futures position data into broader portfolio management or reporting systems.

Properties

Name Meaning
Symbol Name or ID Select the futures trading symbol from a list or specify it dynamically using an expression.

The symbol options are dynamically loaded via a method that fetches available symbols from Binance.

Output

The node outputs JSON data representing the futures position(s) for the specified symbol. The structure typically includes fields such as:

  • Symbol identifier
  • Position amount and side (long/short)
  • Entry price
  • Mark price
  • Unrealized profit/loss
  • Margin type and leverage
  • Other relevant position metrics provided by Binance API

If multiple positions or detailed data are returned, they will be structured as an array of objects under the json output field.

No binary data output is indicated.

Dependencies

  • Requires a valid Binance API key credential configured in n8n to authenticate requests.
  • Relies on Binance's Futures API endpoints to fetch position data.
  • The node uses internal methods to load available symbols dynamically.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Specifying an incorrect or unsupported symbol may result in empty or error responses.
    • Network connectivity problems can prevent API calls from succeeding.

  • Error messages:

    • Authentication failures: Ensure the API key and secret are correctly set up with appropriate permissions.
    • Symbol not found: Verify the symbol name or ID is correct and available on Binance Futures.
    • Rate limit exceeded: Binance enforces rate limits; consider adding delays or reducing request frequency.

Links and References

Discussion