SDKs & Tools

FIX (Python)

Copy page

The Python FIX connector provides access to Binance Financial Information eXchange (FIX) APIs using the FIX protocol.

This connector is intended for advanced and institutional use cases that require low-latency order entry, execution, and session-based trading workflows. It exposes Binance Spot FIX message types and session flows and allows you to place orders, cancel orders, and track order status using FIX messages.

For source code, issues, and release notes, see the binance-fix-connector-python repository on GitHub.

Supported environments

• Python 3.9 or newer
• Backend services and trading systems

This connector is intended for server-side usage only and requires a persistent FIX session.

Scope and capabilities

The FIX Python connector supports:

• Binance Spot FIX Order Entry
• Order placement and cancellation
• Execution reports and order state updates
• Session-based FIX communication

This connector does not replace REST or WebSocket APIs and is designed for specialized trading workflows.

Authentication

⚠️ Important

Binance FIX APIs only support Ed25519 keys. Other authentication methods (such as HMAC or RSA) are not supported.

Before using the FIX connector, ensure that:

• You have generated an Ed25519 key pair
• Your API key has FIX permissions enabled
• You are using the correct FIX endpoint for production or testnet

Refer to the following guides:

• How to generate an Ed25519 key pair (mainnet)
• Binance Spot FIX API documentation

Installation

Install the connector using pip:

Code
pip install binance-fix-connector

The package is published on PyPI as binance-fix-connector. Source code is maintained in the GitHub repository linked above.

Getting started

All FIX messages are created and managed through the create_order_entry_session helper, which establishes a FIX session and exposes utilities to create and send messages.

The example below demonstrates how to establish a FIX Order Entry session and submit a simple limit order.

Code
import time
from binance_fix_connector.fix_connector import create_order_entry_session
from binance_fix_connector.utils import get_private_key

API_KEY = "<your-api-key>"
PRIVATE_KEY = get_private_key("/path/to/private.key")

FIX_OE_URL = "tcp+tls://fix-oe.testnet.binance.vision:9000"

client = create_order_entry_session(
    api_key=API_KEY,
    private_key=PRIVATE_KEY,
    endpoint=FIX_OE_URL,
)

# Wait for logon
client.retrieve_messages_until(message_type="A")

# Create and send a NewOrderSingle (D)
msg = client.create_fix_message_with_basic_header("D")
msg.append_pair(11, str(time.time_ns()))  # ClOrdID
msg.append_pair(55, "BNBUSDT")            # Symbol
msg.append_pair(54, 1)                    # Side (BUY)
msg.append_pair(38, 1)                    # OrderQty
msg.append_pair(40, 2)                    # OrdType (LIMIT)
msg.append_pair(44, 730)                  # Price
msg.append_pair(59, 1)                    # TimeInForce (GTC)

client.send_message(msg)

# Receive execution reports
responses = client.retrieve_messages_until(message_type="8")

Refer to the repository documentation for more examples.

Typical use cases

• Low-latency order entry and execution
• Institutional or professional trading systems
• FIX-based integrations requiring session control
• Advanced trading infrastructure where REST or WebSocket APIs are not sufficient

Notes and best practices

• FIX APIs require a persistent TCP/TLS connection
• Always handle session lifecycle events (logon, heartbeat, logout)
• Use testnet endpoints for development and validation
• Consider implementing reconnect/backoff logic and monitoring session health
• This connector is intended for experienced FIX users
• For general-purpose integrations, prefer REST or WebSocket APIs