Connect OKX to TensorTrader: API key + secret + passphrase, paper first

OKX and TensorTrader

OKX is a major centralized exchange with spot, perpetual swaps and options, and a unified account that shares margin across products.

This guide shows exactly what OKX needs from you, how to create it without withdrawal permission, how to save it in TensorTrader on paper first, and what TensorTrader can do on OKX today. Once connected, TradingView alerts can size, place and protect perpetual orders on your own OKX account.

At a glance

status

Connectable (key storage + verification; execution not yet live-ready)

type

CEX

markets

perps · spot

venue max leverage

100x

credential

API key + secret + passphrase

Create a trade-only OKX key

1. 1Open OKX API and create a key. You choose the passphrase — remember it.
2. 2Permissions: Trade. Do not enable Withdraw.
3. 3Paste API key, secret, and the same passphrase below.

allow

Trade

never

Withdraw · Withdrawals · Transfers / internal sends · Your login password or 2FA codes

• OKX API page ↗

Save the OKX key in TensorTrader

Verification is a real call to the exchange, not a format check. A key that verifies but reads a zero balance usually points at the wrong wallet (spot instead of futures) or an unfunded demo account.

1. 1Sign in and open Settings (the tab on the right edge), then the Exchange Auth tab.
2. 2Pick OKX from the venue list.
3. 3Leave the key marked as testnet / paper. New keys always start there; live is a separate opt-in after preflight.
4. 4Paste the API key and the API secret.
5. 5Paste the passphrase into the Passphrase field. It must be the one you chose when you created this OKX key; a passphrase from another key fails verification.
6. 6On a live-ready venue, testnet credentials save and verify on their own a moment after you stop typing ("Paper/testnet credentials save automatically"). Elsewhere, press Save & Verify. The status turns green and your balance appears when the key works.
7. 7If the venue offers more than one wallet or account, pick the one TensorTrader should trade from in the wallet picker.

What works on OKX today

OKX is connectable but not live-ready. You can save and verify a trade-only key now; execution switches on once the venue passes the same parity checklist as Binance and Hyperliquid (balances, margin, fills, reconcile, fill-based profit). Connecting now also helps us finish it, which is exactly what the Pioneer program rewards.

key storage + verification

Yes: the key is checked with a real call to the exchange.

TradingView alert execution

Yes, paper first.

live-ready (paper-first parity checklist)

Not yet.

paper / testnet path

Venue sandbox or demo keys where the exchange provides them; otherwise the connector stays read-only.

If the OKX key does not verify

TensorTrader treats authentication errors as errors and stops. It never reads a dead OKX key as an empty account.

invalid key

Usually a live key saved as testnet, or the reverse. Match the key to the environment.

bad signature

The passphrase is wrong or belongs to a different key.

IP restricted

The key is locked to other IP addresses; clear the allow-list or add the server’s outbound IP.

zero balance

The key works but the account or wallet it trades is empty, for example funds in spot instead of futures.

permission denied

Trade permission is off; edit the key on the exchange and enable trading (never withdrawals).

Your first OKX order from the Chrome extension

Orders reach OKX through TradingView alerts. The TensorTrader extension builds those alerts for you: open TradingView, open the extension side panel, and use the Batch Create tab. Pick this OKX key in step 1 · Exchanges, type your tokens, choose an indicator or strategy from your TradingView favorites, review the plan and press Create.

When an alert fires, TensorTrader sizes the order, clamps leverage to the lower of your policy and the venue maximum, places it on your key and shows the fill on your dashboard.

• Step-by-step: creating orders with the Chrome extension →
• Batch Create strategies and indicators explained →

Beta Pioneer: 90 days, plus seats to share

A verified trade-only OKX key makes you a Beta Pioneer: your free beta runs 90 days instead of 30, and you get an invite code with 90-day seats for other traders. The code has 5 seats while we are still finishing a venue, and 2 once it is complete.

Find the code under Settings → Community and use "Copy invite link". Each seat gives a new account the same 90-day beta.

Frequently asked questions

Does TensorTrader need withdrawal permission on OKX?

No. Leave withdrawals and transfers off. TensorTrader only needs to trade and read your account.

Can I test OKX without real money?

Use OKX's sandbox or demo keys if it offers them. New keys in TensorTrader always start marked as testnet / paper.

Keep reading

• TradingView webhook automation: from alert to exchange order

  Everything about automating TradingView: alert types, webhook JSON, plan limits, building hundreds of alerts with the Chrome extension, managing them, and executing on 30 exchanges and brokers, paper first.

• Trade-only API keys: which permissions to enable, and which never to enable

  A plain guide to exchange API key permissions for trading bots: what trade, read, transfer and withdraw mean, the passphrase exchanges, IP allow-lists and DEX agent keys.

• Paper trading and testnets on every exchange TensorTrader supports

  Which crypto exchanges and brokers offer a testnet, demo or paper environment, how TensorTrader uses each one, and which venues have no paper path at all.