Skip to content
SmartDOMSmartDOM Help

Bitget

How to connect a Bitget account to SmartDOM with an API key and what the terminal can do with this connection.

What the connection gives you

Section titled “What the connection gives you”

Once connected, SmartDOM shows the account’s balances and positions, keeps the list of orders and lets you trade from the order book. Without a connection the exchange is available for viewing quotes only.

Parameter Value
Markets for trading Spot and Futures (USDT-M)
Passphrase when connecting Required
Demo trading (testnet) No

Where it is in SmartDOM

Section titled “Where it is in SmartDOM”

Settings → Connection → “+ Add connection”.

Step by step

Section titled “Step by step”
  1. Create an API key in your Bitget account. Which permissions to enable: Creating API keys and required permissions. When creating the key Bitget asks you to set a Passphrase.
  2. In SmartDOM open Settings → Connection and click + Add connection.
  3. In the Exchange field select Bitget.
  4. In the Name field enter any clear name, for example “Bitget main”. It is used to tell connections apart.
  5. Paste the API Key and Secret Key.
  6. The Passphrase field appears automatically: Bitget requires it when creating a key. Enter the same phrase you set on the exchange.
  7. Click Verify and save. The terminal contacts the exchange and makes sure the keys work. While checking, “Verifying keys…” is shown.
  8. The new connection appears in the list with the status Disconnected. Click Connect to start trading.

image.png

Notes

Section titled “Notes”
  • Bitget reports the exact reason for rejection: wrong passphrase, time out of sync, IP not whitelisted, insufficient permissions.
  • In one of its responses Bitget does not distinguish between a wrong key, secret and passphrase. If you see “Invalid API keys”, check all three fields.

Common errors

Section titled “Common errors”

  • “Invalid API keys”: the key was copied incompletely, deleted on the exchange or created for another account. Create a new key and paste it again.

  • “Local clock is out of sync with the exchange (>30 s)”: enable automatic time synchronisation in Windows.

  • “IP address is not in the API key whitelist”: the key has an IP restriction on the exchange and your address is not on the list.

  • “The API key has insufficient permissions. Enable Read and Trade.”: account reading and trading permissions were not ticked when creating the key.

  • “Invalid passphrase”: the phrase entered is not the one set when creating the key. A passphrase cannot be viewed on the exchange, only set anew when creating a new key.

  • The key was created in Bitget demo mode. The terminal does not accept such a key: a real account key is required.

The full list of messages and what to do about them: Common connection errors.

Section titled “Related articles”