Bitget V3 UTA JavaScript SDK example: rest-trade-UTA-spot.ts
Bitget V3 UTA REST trade UTA spot JavaScript example for the Siebly Bitget 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/Bitget/V3 - UTA/Rest/rest-trade-UTA-spot.ts
What this example covers
- Bitget REST API JavaScript example.
- Uses the Siebly Bitget SDK package
bitget-apiinstead of hand-written HTTP request plumbing. - Source path:
Bitget/V3 - UTA/Rest/rest-trade-UTA-spot.ts. - Example category: V3 UTA.
- Imports SDK symbols including
RestClientV3,WebsocketClientV3. - Calls SDK methods such as
on(),subscribe(),getBalances(),getInstruments(),submitNewOrder().
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.
/* eslint-disable @typescript-eslint/no-unused-vars */import { PlaceOrderRequestV3, RestClientV3, WebsocketClientV3,} from 'bitget-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_PASS_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/V3/rest-trade-spot.ts // note the single quotes, preventing special characters such as $ from being incorrectly passed const client = new RestClientV3({ apiKey: API_KEY, apiSecret: API_SECRET, apiPass: API_PASS, // apiKey: 'apiKeyHere', // apiSecret: 'apiSecretHere', // apiPass: 'apiPassHere',}); const wsClient = new WebsocketClientV3({ apiKey: API_KEY, apiSecret: API_SECRET, apiPass: API_PASS,}); function logWSEvent(type: string, data: any) { console.log(new Date(), `WS ${type} event: `, data);} // simple sleep functionfunction promiseSleep(milliseconds: number) { return new Promise((resolve) => setTimeout(resolve, milliseconds));} /** This is a simple script wrapped in a immediately invoked function expression, designed to check for any available BTC balance and immediately sell the full amount for USDT */(async () => { try { // Add event listeners to log websocket events on account wsClient.on('update', (data) => logWSEvent('update', data)); wsClient.on('open', (data) => logWSEvent('open', data)); wsClient.on('response', (data) => logWSEvent('response', data)); wsClient.on('reconnect', (data) => logWSEvent('reconnect', data)); wsClient.on('reconnected', (data) => logWSEvent('reconnected', data)); wsClient.on('authenticated', (data) => logWSEvent('authenticated', data)); wsClient.on('exception', (data) => logWSEvent('exception', data)); // Subscribe to private account topics // Account updates for UTA (unified trading account) wsClient.subscribe( { topic: 'account', payload: { instType: 'UTA', }, }, 'v3Private', ); // Order updates for spot wsClient.subscribe( { topic: 'order', payload: { instType: 'UTA', }, }, 'v3Private', ); // wait briefly for ws to be ready (could also use the response or authenticated events, to make sure topics are subscribed to before starting) await promiseSleep(2.5 * 1000); const balanceResult = await client.getBalances(); const allBalances = balanceResult.data; const balanceBTC = allBalances.assets?.find( (bal) => bal.coin === 'BTC' || bal.coin === 'btc', ); const btcAmount = Number(allBalances.usdtEquity) > 0 ? Number(balanceBTC?.available) : 0; console.log('balance: ', JSON.stringify(allBalances, null, 2)); console.log('BTC balance result: ', balanceBTC); if (!btcAmount) { console.error('No BTC to trade'); return; } console.log(`BTC available: ${btcAmount}`); const symbol = 'BTCUSDT'; const symbolsResult = await client.getInstruments({ category: 'SPOT', symbol: symbol, }); const btcRules = symbolsResult.data.find((rule) => rule.symbol === symbol); console.log('btc trading rules: ', btcRules); if (!btcRules) { return console.log('no rules found for trading ' + symbol); } const quantity = btcRules.minOrderQty; const order: PlaceOrderRequestV3 = { symbol: symbol, side: 'sell', orderType: 'market', category: 'SPOT', qty: quantity, } as const; console.log('submitting order: ', order); const sellResult = await client.submitNewOrder(order); console.log('sell result: ', sellResult); } catch (e) { console.error('request failed: ', e); }})();