# BuildTokenSwap

### Description

This endpoint returns the transaction detail that is needed to perform the actual swap, based on information obtained in the **Get Exchange Rate** endpoint. This endpoint will build a transaction for you, which afterward you or your user needs to execute. Each item in the response array needs to be taken, enriched with the relevant signing method and submitted against the endpoint:\ `/api/transactions/execute`

{% code overflow="wrap" %}

```csharp
public static VyTask<VyTransactionRequestBase[]> BuildTokenSwap(string id, VyBuildTokenSwapRequest reqParams)
```

{% endcode %}

{% tabs %}
{% tab title="Details" %}
**Parameters**

| id        | string                                                                                                 | This is the \`ID\` of the source wallet. (Wallet that holds tokens to swap) |
| --------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| reqParams | [VyBuildTokenSwapRequest](/sdk-reference/c-sdk-v3/object-references/wallet/vybuildtokenswaprequest.md) | Request data for the operation                                              |

**Returns**

VyTask<[VyTransactionRequestBase](/sdk-reference/c-sdk-v3/object-references/wallet/vytransactionrequestbase.md)\[]>\
Swap transactions created successfully.
{% endtab %}
{% endtabs %}

## Relevant Functions

* [VyTask\<VyAeTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_0.md)
* [VyTask\<VyArbitrumContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_1.md)
* [VyTask\<VyArbitrumErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_2.md)
* [VyTask\<VyArbitrumErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_3.md)
* [VyTask\<VyArbitrumTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_4.md)
* [VyTask\<VyAvacContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_5.md)
* [VyTask\<VyAvacErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_6.md)
* [VyTask\<VyAvacErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_7.md)
* [VyTask\<VyAvacTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_8.md)
* [VyTask\<VyBaseContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_9.md)
* [VyTask\<VyBaseErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_10.md)
* [VyTask\<VyBaseErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_11.md)
* [VyTask\<VyBaseTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_12.md)
* [VyTask\<VyBscBep20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_13.md)
* [VyTask\<VyBscContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_14.md)
* [VyTask\<VyBscErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_15.md)
* [VyTask\<VyBscTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_16.md)
* [VyTask\<VyBtcTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_17.md)
* [VyTask\<VyEthereumErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_18.md)
* [VyTask\<VyEthereumErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_19.md)
* [VyTask\<VyEthTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_20.md)
* [VyTask\<VyEthereumContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_21.md)
* [VyTask\<VyGo20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_22.md)
* [VyTask\<VyGoTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_23.md)
* [VyTask\<VyHbarTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_24.md)
* [VyTask\<VyHederaApproveAllowanceRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_25.md)
* [VyTask\<VyHederaMultiTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_26.md)
* [VyTask\<VyHederaNftTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_27.md)
* [VyTask\<VyHederaTokenAssociationRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_28.md)
* [VyTask\<VyHederaTokenCreationRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_29.md)
* [VyTask\<VyHederaTokenMintRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_30.md)
* [VyTask\<VyHederaTokenTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_31.md)
* [VyTask\<VyImxCollectionCreationTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_32.md)
* [VyTask\<VyImxErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_33.md)
* [VyTask\<VyImxErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_34.md)
* [VyTask\<VyImxMetadataSchemaCreationTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_35.md)
* [VyTask\<VyImxNativeTransferTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_36.md)
* [VyTask\<VyImxProjectCreationTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_37.md)
* [VyTask\<VyImxTokenMintTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_38.md)
* [VyTask\<VyLtcTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_39.md)
* [VyTask\<VyMaticContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_40.md)
* [VyTask\<VyMaticErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_41.md)
* [VyTask\<VyMaticErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_42.md)
* [VyTask\<VyMaticTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_43.md)
* [VyTask\<VyNeoContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_44.md)
* [VyTask\<VyNeoGasTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_45.md)
* [VyTask\<VyNeoNativeTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_46.md)
* [VyTask\<VyVip180TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_47.md)
* [VyTask\<VyVechainContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_48.md)
* [VyTask\<VyVechainErc1155TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_49.md)
* [VyTask\<VyVetTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_50.md)
* [VyTask\<VyVthoTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_51.md)
* [VyTask\<VyXplaContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_52.md)
* [VyTask\<VyXplaCw20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_53.md)
* [VyTask\<VyXplaErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_54.md)
* [VyTask\<VyXplaTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_55.md)
* [VyTask\<VyOptimismContractExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_56.md)
* [VyTask\<VyOptimismErc20TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_57.md)
* [VyTask\<VyOptimismErc721TransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_58.md)
* [VyTask\<VyOptimismTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_59.md)
* [VyTask\<VySolanaNftTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_60.md)
* [VyTask\<VySolanaProgramExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_61.md)
* [VyTask\<VySolanaTokenTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_62.md)
* [VyTask\<VySolanaTransferTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_63.md)
* [VyTask\<VySuiTransferTransactionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_64.md)
* [VyTask\<VySuiTokenTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_65.md)
* [VyTask\<VySuiPackageExecutionRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_66.md)
* [VyTask\<VySuiNftTransferRequest\[\]> BuildTokenSwap (VyBuildTokenSwapRequest ...)](/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap/buildtokenswap_67.md)


---

# 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://sdk.venly.io/sdk-reference/c-sdk-v3/function-references/wallet/token-swapping/buildtokenswap.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.