🟨 JavaScript / TypeScript SDK

npm install @storm-trade/trading-sdk @ton/ton

import { TonClient } from '@ton/ton';
import { StormTradingSdk } from '@storm-trade/trading-sdk/sdk';
import { StormClient, OracleClient } from '@storm-trade/trading-sdk/api-clients';
 
// Stage. For Mainnet use https://oracle.storm.tg, https://api.storm.tg/api
// and https://toncenter.com/api/v2/jsonRPC.
const ORACLE_URL = 'https://oracle.stage.stormtrade.dev';
const STORM_API_URL = 'https://api.stage.stormtrade.dev/api';
const TON_CENTER = 'https://testnet.toncenter.com/api/v2/jsonRPC';
 
const tonClient = new TonClient({ endpoint: TON_CENTER, apiKey: TONCENTER_API_KEY });
 
const sdk = new StormTradingSdk(
  new StormClient(STORM_API_URL, new OracleClient(ORACLE_URL)),
  tonClient,
  TRADER_ADDRESS, // the wallet that will sign, string or Address
);
await sdk.init(); // loads markets, vaults and contract addresses

import { Direction, OrderType } from '@storm-trade/trading-sdk/sdk';
 
// Market long, 1 TON collateral, 2x, with SL/TP created on execution
const open = await sdk.createMarketOpenOrder({
  baseAssetName: 'XRP',
  collateralAssetName: 'TON',
  direction: Direction.long,
  amount: 1_000_000_000n,
  leverage: 2_000_000_000n,
  minBaseAssetAmount: 900_000_000n,   // slippage guard, optional
  stopTriggerPrice: 80_000_000_000n,  // optional
  takeTriggerPrice: 120_000_000_000n, // optional
});
 
// Limit order
const limit = await sdk.createLimitOrder({
  baseAssetName: 'XRP',
  collateralAssetName: 'TON',
  direction: Direction.long,
  amount: 1_000_000_000n,
  leverage: 2_000_000_000n,
  limitPrice: 100_000_000_000n,
});
 
// Stop-market and stop-limit
await sdk.createStopMarketOrder({ /* ...same fields... */ stopPrice: 105_000_000_000n });
await sdk.createStopLimitOrder({ /* ...same fields... */ stopPrice: 105_000_000_000n, limitPrice: 106_000_000_000n });
 
// Cancel a resting order by type and index from the position manager
const cancel = await sdk.cancelOrder({
  baseAssetName: 'XRP',
  collateralAssetName: 'TON',
  direction: Direction.long,
  orderType: OrderType.limit,
  orderIndex: 0,
});

// Stop-Loss / Take-Profit on an open position
await sdk.createStopLossOrder({ baseAssetName: 'XRP', collateralAssetName: 'TON', direction: Direction.long, amount: 1_000_000_000n, triggerPrice: 90_000_000_000n });
await sdk.createTakeProfitOrder({ baseAssetName: 'XRP', collateralAssetName: 'TON', direction: Direction.long, amount: 1_000_000_000n, triggerPrice: 110_000_000_000n });
 
// Close, size is base asset with 9 decimals
await sdk.createClosePositionOrder({ baseAssetName: 'XRP', collateralAssetName: 'TON', direction: Direction.long, size: 1_000_000_000n });
 
// Margin. The SDK fetches a signed oracle price for these two calls.
await sdk.addMargin({ baseAssetName: 'XRP', collateralAssetName: 'TON', direction: Direction.long, amount: 500_000_000n });
await sdk.removeMargin({ baseAssetName: 'XRP', collateralAssetName: 'TON', direction: Direction.long, amount: 200_000_000n });

await sdk.provideLiquidity({ assetName: 'USDT', amount: 1_000_000n }); // 1 USDT, 6 decimals
await sdk.withdrawLiquidity({ assetName: 'TON', amountOfSLP: 500_000_000n }); // 0.5 SLP

import { TonConnectUI } from '@tonconnect/ui';
 
const tonConnectUI = new TonConnectUI({ manifestUrl: 'https://your-app.com/tonconnect-manifest.json' });
 
const tx = await sdk.createMarketOpenOrder({ /* ... */ });
await tonConnectUI.sendTransaction({
  validUntil: Math.floor(Date.now() / 1000) + 300,
  messages: [{
    address: tx.to.toString(),
    amount: tx.value.toString(),
    payload: tx.body.toBoc().toString('base64'),
  }],
});

import { internal, WalletContractV4 } from '@ton/ton';
import { mnemonicToPrivateKey } from '@ton/crypto';
 
const keyPair = await mnemonicToPrivateKey(MNEMONIC.split(' '));
const wallet = tonClient.open(WalletContractV4.create({ workchain: 0, publicKey: keyPair.publicKey }));
 
const tx = await sdk.createMarketOpenOrder({ /* ... */ });
await wallet.sendTransfer({
  seqno: await wallet.getSeqno(),
  secretKey: keyPair.secretKey,
  messages: [internal(tx)],
});