NexusTrader

Use the exec tool to run bridge.py. Do not write code or call external HTTP APIs directly.

bridge.py connects to a local MCP server at 127.0.0.1:18765 (SSE) — all exchange communication goes through that server.

Security Considerations

This skill accesses your exchange API keys. Before using:

• API keys are stored in {NEXUSTRADER_PROJECT_DIR}/.keys/.secrets.toml — a local file, never transmitted by this skill.
• Auto-start is disabled by default. The skill will not start background processes unless you explicitly set NEXUSTRADER_NO_AUTOSTART=0 in the skill's .env file.
• If auto-start is enabled, the NexusTrader-mcp daemon will run in the background and hold access to your API keys.
• Start with testnet/demo keys. Only use real keys after verifying the workflow in a sandbox.
• Orders require explicit user confirmation — verify your agent flow enforces this before live trading.
• See upstream docs for key setup: https://github.com/Quantweb3-com/NexusTrader-mcp

Environment Variables

• NEXUSTRADER_PROJECT_DIR (optional, default: ~/NexusTrader-mcp): Location of your NexusTrader-mcp project directory. Controls where .keys/.secrets.toml is read from.
• NEXUSTRADER_NO_AUTOSTART (default: 1): Set to 0 to allow bridge.py to auto-start the MCP daemon when offline. Default 1 means you must start the server manually.
• NEXUSTRADER_MCP_URL (optional, default: http://127.0.0.1:18765/sse): MCP server address if running on a non-default port.

Usage

Get all balances:

exec {baseDir}/bridge.py get_all_balances

Get all positions:

exec {baseDir}/bridge.py get_all_positions

Get balance for one exchange:

exec {baseDir}/bridge.py get_balance --exchange=okx

Get ticker:

exec {baseDir}/bridge.py get_ticker --symbol=BTCUSDT-PERP.BINANCE

Get klines:

exec {baseDir}/bridge.py get_klines --symbol=BTCUSDT-PERP.BINANCE --interval=1h --limit=24

Get open orders:

exec {baseDir}/bridge.py get_open_orders --exchange=okx

Get position for one symbol:

exec {baseDir}/bridge.py get_position --symbol=BTCUSDT-PERP.OKX

Place order (confirm first):

exec {baseDir}/bridge.py create_order --symbol=BTCUSDT-PERP.BINANCE --side=BUY --order_type=MARKET --amount=0.001

Cancel order (confirm first):

exec {baseDir}/bridge.py cancel_order --symbol=BTCUSDT-PERP.BINANCE --order_id=123

Symbol format: BTCUSDT-PERP.OKX / ETHUSDT-SPOT.BYBIT. Exchange names lowercase.

If exec returns {"error": ...} → explain in Chinese.

If server not running → tell user to start manually: cd ~/NexusTrader-mcp && uv run nexustrader-mcp start

For orders, always confirm with user before calling create_order/cancel_order/modify_order.