OKX JavaScript SDK example: rest-private-trade-market.ts
OKX REST private trade market JavaScript example for the Siebly OKX SDK, covering exchange REST API and WebSocket integration, setup, and production SDK docs.
We use environment variables in our examples for API keys. It is your responsibility to manage and secure your keys appropriately.
examples/OKX/Rest/rest-private-trade-market.ts
What this example covers
- OKX REST API JavaScript example.
- Uses the Siebly OKX SDK package
okx-apiinstead of hand-written HTTP request plumbing. - Source path:
OKX/Rest/rest-private-trade-market.ts. - Imports SDK symbols including
RestClient. - Calls SDK methods such as
getBalance(),submitOrder().
How to use this example
- Start here for the specific request or stream pattern, then check the matching SDK guide for install, credentials, and operational notes.
- Open the repository source when you need the latest committed version: GitHub source file.
import { OrderRequest, RestClient } from 'okx-api'; // read from environmental variablesconst API_KEY = process.env.API_KEY_COM;const API_SECRET = process.env.API_SECRET_COM;const API_PASS = process.env.API_PASSPHRASE_COM; // If running from CLI in unix, you can pass env vars as such:// API_KEY_COM='lkm12n3-2ba3-1mxf-fn13-lkm12n3a' API_SECRET_COM='035B2B9637E1BDFFEE2646BFBDDB8CE4' API_PASSPHRASE_COM='ComplexPa$$!23$5^' ts-node examples/rest-private-trade-market.ts // note the single quotes, preventing special characters such as $ from being incorrectly passed if (!API_KEY || !API_SECRET || !API_PASS) { throw new Error( 'Missing api credentials. Use environmental variables or hard code in the script', );} console.log(new Date(), 'Using credentials: ', { API_KEY, API_SECRET, API_PASS,}); const client = new RestClient({ apiKey: API_KEY, // apiKey: 'apiKeyHere', apiSecret: API_SECRET, // apiSecret: 'apiSecretHere', apiPass: API_PASS, // apiPass: 'apiPassHere',}); /** Get available balance for an asset */async function getAssetBalance( client: RestClient, coin: string,): Promise<number | null> { const allBalances = await client.getBalance(); const usdtBalanceResult = allBalances[0].details.find( (bal) => bal.ccy === coin, ); const usdtBalance = Number(usdtBalanceResult?.availBal); if (!usdtBalanceResult || !usdtBalance || isNaN(usdtBalance)) { return null; } return usdtBalance;} /** * This is a simple REST API demo script wrapped in a immediately invoked function expression. The logic below will immediately execute if you run this script. * * It is designed to: * - check for any available USDT balance * - immediately use half the balance to buy bitcoin (in spot) * - check the available BTC balance * - immediately sell all available BTC back to USDT */(async () => { try { const usdtBalance = await getAssetBalance(client, 'USDT'); if (!usdtBalance) { console.error('No USDT to trade'); return; } console.log(`USDT available: ${usdtBalance}`); const symbol = 'BTC-USDT'; const percentBalanceToUse = 50; const quantity = usdtBalance * (percentBalanceToUse / 100); const buyOrder: OrderRequest = { instId: symbol, ordType: 'market', side: 'buy', sz: String(quantity), tdMode: 'cash', tgtCcy: 'base_ccy', }; console.log('submitting buy order:', buyOrder); const buyResult = await client.submitOrder(buyOrder); console.log('buy order result: ', buyResult, '\n\n'); const btcBalance = await getAssetBalance(client, 'BTC'); if (!btcBalance) { console.error('No BTC to trade'); return; } console.log(`BTC available: ${btcBalance}`); const sellOrder: OrderRequest = { instId: symbol, ordType: 'market', side: 'sell', sz: String(btcBalance), tdMode: 'cash', tgtCcy: 'base_ccy', }; console.log('submitting sell order:', sellOrder); const sellResult = await client.submitOrder(sellOrder); console.log('sell order result: ', sellResult, '\n\n'); const usdtBalanceFinal = await getAssetBalance(client, 'USDT'); console.log('final balance: ', usdtBalanceFinal); } catch (e) { console.error('request failed: ', e); }})();