Bitget¶

Bitget is a global cryptocurrency exchange offering spot, futures, and copy-trading products. NexusTrader supports Bitget through the BitgetAccountType enum.

Account Types¶

Account Type	Description
`BitgetAccountType.UTA`	Unified Trading Account (live)
`BitgetAccountType.SPOT`	Spot account (live)
`BitgetAccountType.FUTURE`	Futures account (live)
`BitgetAccountType.UTA_DEMO`	Unified Trading Account (demo / paper trading)
`BitgetAccountType.SPOT_DEMO`	Spot demo account
`BitgetAccountType.FUTURE_DEMO`	Futures demo account
`BitgetAccountType.SPOT_MOCK`	Spot mock connector (local simulation)
`BitgetAccountType.LINEAR_MOCK`	Linear futures mock connector
`BitgetAccountType.INVERSE_MOCK`	Inverse futures mock connector

Note

For demo trading use UTA_DEMO for both public_conn_config and private_conn_config. The testnet flag in BasicConfig enables demo mode.

Note

Bitget requires a passphrase in addition to the API key and secret. Set it via BasicConfig(passphrase=...).

API Keys Setup¶

Add your credentials to .keys/.secrets.toml:

[BITGET.DEMO]
api_key = "your_api_key"
secret = "your_secret_key"
passphrase = "your_passphrase"

You can access them manually in your strategy, or use the settings_key parameter in BasicConfig to auto-resolve (see below).

from nexustrader.constants import settings

API_KEY    = settings.BITGET.DEMO.API_KEY
SECRET     = settings.BITGET.DEMO.SECRET
PASSPHRASE = settings.BITGET.DEMO.PASSPHRASE

Configuration Example¶

from nexustrader.config import (
    Config,
    PublicConnectorConfig,
    PrivateConnectorConfig,
    BasicConfig,
)
from nexustrader.constants import ExchangeType
from nexustrader.exchange import BitgetAccountType

config = Config(
    strategy_id="bitget_demo",
    user_id="user_test",
    strategy=MyStrategy(),
    basic_config={
        ExchangeType.BITGET: BasicConfig(
            settings_key="BITGET.DEMO",
            testnet=True,
        )
    },
    public_conn_config={
        ExchangeType.BITGET: [
            PublicConnectorConfig(
                account_type=BitgetAccountType.UTA_DEMO,
                enable_rate_limit=True,
            )
        ]
    },
    private_conn_config={
        ExchangeType.BITGET: [
            PrivateConnectorConfig(
                account_type=BitgetAccountType.UTA_DEMO,
                enable_rate_limit=True,
            )
        ]
    },
)

Symbol Format¶

Bitget symbols follow the standard NexusTrader convention:

Spot: BTCUSDT.BITGET
Perpetual futures: BTCUSDT-PERP.BITGET