Binance Exchange

Binance Account Types

Binance provides multiple account types. For testing environment, you can use account types with _TESTNET suffix.

from nexustrader.exchange.binance import BinanceAccountType

account_type = BinanceAccountType.USD_M_FUTURE  # or other account types

  • BinanceAccountType.SPOT: Spot account

  • BinanceAccountType.MARGIN: Cross margin account

  • BinanceAccountType.ISOLATED_MARGIN: Isolated margin account

  • BinanceAccountType.USD_M_FUTURE: USD-M futures account

  • BinanceAccountType.COIN_M_FUTURE: COIN-M futures account

  • BinanceAccountType.PORTFOLIO_MARGIN: Portfolio margin account

  • BinanceAccountType.SPOT_TESTNET: Spot testnet account

  • BinanceAccountType.USD_M_FUTURE_TESTNET: USD-M futures testnet account

  • BinanceAccountType.COIN_M_FUTURE_TESTNET: COIN-M futures testnet account

Note

For futures trading on testnet, make sure to use USD_M_FUTURE_TESTNET or COIN_M_FUTURE_TESTNET account types. For spot trading on testnet, use SPOT_TESTNET. Only SPOT, USD_M_FUTURE, COIN_M_FUTURE can be passed to public_conn_config.

Binance Config

The most important part is the config object. You need to pass the config object to the Engine class. The config receives the following parameters:

  • strategy_id: The id of the strategy

  • user_id: The id of the user

  • strategy: The strategy class

  • basic_config: The basic config of the exchange

  • public_conn_config: The public connector config of the exchange

  • private_conn_config: The private connector config of the exchange

from nexustrader.exchange.binance import BinanceAccountType
from nexustrader.config import Config, PublicConnectorConfig, PrivateConnectorConfig, BasicConfig

# The strategy code....

config = Config(
    strategy_id="buy_and_sell_binance",
    user_id="user_test",
    strategy=Demo(),
    basic_config={
        ExchangeType.BINANCE: BasicConfig(
            settings_key="BINANCE.FUTURE.TESTNET_1",
            testnet=True,
        )
    },
    public_conn_config={
        ExchangeType.BINANCE: [
            PublicConnectorConfig(
                account_type=BinanceAccountType.USD_M_FUTURE_TESTNET,
            )
        ]
    },
    private_conn_config={
        ExchangeType.BINANCE: [
            PrivateConnectorConfig(
                account_type=BinanceAccountType.USD_M_FUTURE_TESTNET,
            )
        ]
    }
)

engine = Engine(config)

if __name__ == "__main__":
    try:
        engine.start()
    finally:
        engine.dispose()