Skip to Content

Connecting to OKX

To connect OKX to JetScalp, create an API key in your OKX account and enter it in the connection settings.

OKX issues three values:

  • API Key — the API key identifier.
  • Secret Key — the secret key used to sign requests.
  • Passphrase — a passphrase you set yourself when creating the key.

Official guide: OKX API FAQ .

1.Open API key management

Sign in on the OKX website, go to Profile → API and connections (or open the OKX API keys page ) and click Create API key. You can also create a key in the OKX mobile app.

2.Create an API key

Enter an API key name, for example JetScalp, and select the account for the connection. In the Purpose field, select the option for using the API with a third-party application, if available. If JetScalp is not among the suggested third-party applications, create a regular API key.

3.Set a passphrase

When you create the key, OKX asks you to set a Passphrase — a password you make up yourself, for example MyJetScalp2026. Save it together with the API Key and Secret Key.

Important: The Passphrase cannot be recovered. If you forget it, delete the API key and create a new one.

4.Configure permissions

PermissionDescription
ReadAccount information, balance, orders and other data.
TradePlacing and canceling orders.
WithdrawWithdrawals.

For JetScalp, enable:

  • Read
  • Trade
  • Withdraw

Important: JetScalp does not need the withdrawal permission (Withdraw) — do not enable it.

5.Restrict access by IP

For a trading key, turn on the IP Allowlist and enter the public IP address JetScalp connects to OKX from. You can bind up to 20 IP addresses to one key. If JetScalp works through a proxy, enter the IP address OKX sees when you connect through that proxy.

If you do not know which IP to enter, find it out first: with a wrong IP, OKX rejects the connection.

6.Confirm creation and save the key

Complete the security verification and confirm creating the key. OKX shows the API Key, Secret Key and Passphrase — save all three values right away.

Important: The Secret Key and Passphrase cannot be recovered later. If they are lost, delete the key and create a new one.

7.Check the position mode

JetScalp supports OKX derivatives trading only in One-way mode (net_mode in the OKX API).

If Hedge mode (long_short_mode in the OKX API) is enabled on the account, the connection is not established and JetScalp shows this message:

OKX: the account is in long/short position mode. JetScalp supports only net mode — switch the position mode in the OKX settings. Connection aborted.

To switch the mode, open the OKX trading settings (in the app: Menu → Settings → Trading mode) and select One-way mode under Position mode. As a rule, the mode cannot be changed while you have open positions or orders.

The position mode is a setting of your OKX account; JetScalp does not change it.

8.Add the connection in JetScalp

Open Settings Settings → Connections, click Add connection below the connection list and click the tile OKX. The connection appears in the list, and its settings appear on the right.

Fill in the connection settings:

FieldValue
NameThe connection name in the list. By default it is the exchange or broker name; you can change it.
API KeyThe API Key from OKX.
Secret KeyThe Secret Key from OKX.
PassphraseThe Passphrase you set when creating the API key in OKX.
ProxyA proxy from the list or None. See Proxy settings.

9.Turn on the connection and check

Turn the connection on with the switch on the right of its row in the list. The state appears under the connection name: first connecting…, then connected. If the connection fails, the error text appears there — the full text is shown in the tooltip and in the header of the connection settings. For all states, see Connections.

Check that:

  • OKX is connected.
  • The account balance is shown.
  • Open positions are shown.
  • Orders are placed and canceled.

If the connection does not work

Invalid API Key or Secret Key

Check that both keys are copied completely and without extra spaces.

Invalid Passphrase

The Passphrase must exactly match the one you set when creating the key. A forgotten Passphrase cannot be recovered — delete the key and create a new one.

Insufficient permissions

If quotes and account information work but orders are not placed, check that the key has the Trade permission.

Hedge mode is enabled

If JetScalp reports that the OKX account is in long/short position mode, switch the position mode to One-way mode (see step 7).

IP restriction

If the key has an IP restriction, make sure the IP address of the computer or proxy is in the allowed list.

API key expired

Keys with Trade or Withdraw permissions that are not bound to an IP address may expire after 14 days of inactivity. That is why you should turn on the IP Allowlist for a trading key.

Security

Never share your API Key, Secret Key and Passphrase — not in chats or Telegram, not with support, not on forums, in screenshots or public repositories.

JetScalp does not need the withdrawal permission — do not enable it.

If the key may have reached anyone else, delete it in OKX right away and create a new one.

Last updated on