# Perform Swap

This guide demonstrates how to perform a token swap using the Torch Finance SDK. 

## Example: Swapping TON for tsTON

### 1. Import modules & Initialize SDK

```typescript
import { TorchSDK, generateQueryId, SwapParams, toUnit } from '@torch-finance/sdk';
import { Asset } from '@torch-finance/core';

const sdk = new TorchSDK();
```

### 2. Define Swap Parameters

Now, configure the parameters for swapping **0.01 TON** for **tsTON**.  

{% hint style="warning" %}
Your transaction will be refunded if your slippage tolerance is too low. Unless you know what you are doing, it is recommended to set the `slippageTolerance` to 0.01 (1%) or leave it empty to avoid transaction failure.
{% endhint %}

```typescript
// recommend to generate queryId for every actions
const queryId = await generateQueryId();

// Define assets
const tonAsset = Asset.ton();
const tsTONAsset = Asset.jetton("EQC98_qAmNEptUtPc7W6xdHh_ZHrBUFpw5Ft_IzNU20QAJav");

// TON has 9 decimals
const assetInDecimals = 9;

// Define the swap
const swapParams: SwapParams = {
  mode: 'ExactIn',
  queryId: queryId,
  assetIn: tonAsset,
  assetOut: tsTONAsset,
  amountIn: toUnit('0.01', assetInDecimals), // 0.01 TON
  slippageTolerance: 0.01, // 1%
};
```

### 3.  Preview the Swap

Simulate the swap to preview important details like the execution price and the estimated output amount.

```typescript
const { result, getSwapPayload } = await sdk.simulateSwap(swapParams);
console.log(`Execution Price: 1 tsTON = ${result.executionPrice} TON`);
console.log(`Estimated Amount Out: ${result.amountOut}`);
console.log(`Min Amount Out: ${result.minAmountOut}`);
```

**Output Example:**

```bash
Execution Price: 1 tsTON = 1.04 TON (This is human readable execution price)
Estimated Amount Out: 9900000 (You should handle decimal part by yourself)
Min Amount Out: 9801000
```

### 4. Execute the Swap

Finally, execute the transaction and retrieve the `msgHash`, which can be used to track its status. 

{% hint style="success" %}
You may need to create wallet instance with mnemonic to send transaction, you can find  full implantation here:  <https://github.com/torch-core/torch-sdk-examples/blob/main/backend-examples/swap.ts>
{% endhint %}

#### 4.1 Execute Swap with Simulation Result

Invoke the callback function returned by simulate swap method

```typescript
// Send Transaction and get msghash
const sender = wallet.address;
const senderArgs = await getSwapPayload(sender, {
    blockNumber: blockNumber, // Optional, but it will speed up a lot if you provided the latest blockNumber here
  });
const msgHash = await send(senderArgs); 
console.log(`Transaction sent with msghash: ${msgHash}`);

// ... Query transaction hash by message hash via Toncenter API V3 or TON Console
```

#### 4.2 Execute Swap Directly with Swap Params

Invoke sdk.getSwapPayload directly

```typescript
const sender = wallet.address;
const senderArgs = await sdk.getSwapPayload(sender, {
    blockNumber: blockNumber, // Optional, but it will speed up a lot if you provided the latest blockNumber here
  });
const msgHash = await send(senderArgs); 
console.log(`Transaction sent with msghash: ${msgHash}`);
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.torch.finance/dex/developer-guide/dex-sdk-guide/perform-swap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.