# spark\_flashnet\_executeSwap

{% hint style="info" %}
This method is coming :soon:
{% endhint %}

Use the `spark_flashnet_executeSwap` method to request a **Flashnet swap** directly from the user’s Spark wallet.

Your app provides the swap parameters (pool, assets, amount, slippage, etc.), and the wallet handles the full Flashnet swap process.

This abstracts all back-and-forth with Flashnet into a **single request**, making swaps simple and secure.

## Parameters

{% hint style="success" %}
:rocket: Become an **Xverse Partner** to enable **integrator fees for your app ⇒** [**reach out**](https://calendly.com/jan-xverse) to get started
{% endhint %}

<table><thead><tr><th width="223.1796875">Request parameters</th><th>Description</th></tr></thead><tbody><tr><td><code>poolId</code></td><td>a string representing the Flashnet liquidity pool to use</td></tr><tr><td><code>assetInAddress</code>   <br></td><td>a string representing the address of the Spark asset being swapped in</td></tr><tr><td><code>assetOutAddress</code></td><td>a string representing the address of the Spark asset being swapped out </td></tr><tr><td><code>amountIn</code></td><td>a string representing the amount of input asset (in sats or smallest unit)</td></tr><tr><td><code>maxSlippageBps</code></td><td>Max slippage in basis points (e.g. 50 = 0.5%)</td></tr><tr><td><code>minAmountOut</code></td><td><span data-gb-custom-inline data-tag="emoji" data-code="2139">ℹ️</span> Optional - a string representing the minimum acceptable output amount</td></tr><tr><td><code>totalIntegratorFeeRateBps</code></td><td>Fee (in basis points) your app requests for routing the swap.<br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span><strong>To activate your app fee, you must be an approved Xverse partner.</strong> If you’re not approved, Xverse will ignore this value and apply its own default fee instead.<br><span data-gb-custom-inline data-tag="emoji" data-code="1f680">🚀</span> <a href="https://calendly.com/jan-xverse"><strong>Contact Xverse</strong></a> to become a partner and activate your app fee. </td></tr><tr><td><code>integratorPublicKey</code></td><td>Public key where your integrator fees should be sent.<br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> <strong>Only partner-approved (whitelisted) keys are accepted.</strong><br>If you pass a non-partner key, Xverse will replace it with its own.<br><span data-gb-custom-inline data-tag="emoji" data-code="1f680">🚀</span> <a href="https://calendly.com/jan-xverse"><strong>Contact Xverse</strong></a> to become a partner and get your key whitelisted.</td></tr><tr><td><code>userPublicKey</code></td><td>a string which must match the connected user's Spark public key</td></tr><tr><td><code>nonce</code></td><td><span data-gb-custom-inline data-tag="emoji" data-code="2139">ℹ️</span> Optional - a string representing a unique swap nonce</td></tr></tbody></table>

## Example

```typescript
import { request } from "sats-connect";

try {
  const response = await request("spark_flashnet_executeSwap", {
    poolId: "03aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
    assetInAddress: "03bitcoinassetpubkey0000000000000000000000000000000000000000000000",
    assetOutAddress: "03usdstablecoinpubkey111111111111111111111111111111111111111111111",
    amountIn: "100000000", // in sats or smallest token units
    maxSlippageBps: 50, // 0.50% tolerance
    minAmountOut: "99500000", // optional safety check
    totalIntegratorFeeRateBps: 100, // 1.00% fee
    integratorPublicKey: "03aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899",
    userPublicKey: "02abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567",
    nonce: "unique-swap-nonce-123"
  });

  if ("result" in response) {
    console.log("Swap result:", response.result);
  } else {
    console.error("Swap failed:", response.error.message);
  }
} catch (error) {
  console.error("Unexpected error:", error);
}


```

## What `spark_flashnet_executeSwap` does

When called, this method:

1. Shows the user a **confirmation screen** with the swap details (pool, asset in/out, amount, fees, slippage).
2. On confirmation, the wallet:
   * Initiates the Spark transfer and authenticates your user with a Flashnet JWT
   * Generates the swap intent
   * Signs with the user’s Spark key
   * Submits to Flashnet
   * Returns the result (success or rejection)
3. Displays a **progress screen** while the steps complete.
4. Returns the swap result to the dApp.

<figure><img src="/files/BqMbjrcxkzUNKoOPnMPP" alt="" width="375"><figcaption></figcaption></figure>

## Responses&#x20;

The method returns a Promise that resolves to the `SparkFlashnetSwapResult`object

#### :white\_check\_mark: Success

```json
{
  "accepted": true,
  "amountOut": 4975000,
  "assetInAddress": "03bitcoinassetpubkey0000000000000000000000000000000000000000000000",
  "assetOutAddress": "03usdstablecoinpubkey111111111111111111111111111111111111111111111",
  "executionPrice": "0.00004975",
  "feeAmount": 5000,
  "outboundTransferId": "spark-transfer-out-123",
  "requestId": "01HJZKFABCDEFGHJKLMNPQRSTVW"
}

```

#### :x: Failure

```json
{
  "accepted": false,
  "error": "Insufficient liquidity in pool",
  "refundTransferId": "spark-transfer-refund-456",
  "refundedAmount": 100000000,
  "refundedAssetAddress": "03bitcoinassetpubkey0000000000000000000000000000000000000000000000",
  "requestId": "01HJZKFABCDEFGHJKLMNPQRSTVW"
}


```


---

# 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://docs.xverse.app/sats-connect/spark-methods/flashnet-trading/spark_flashnet_executeswap.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.