> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# getSwapStatus

# getSwapStatus

Gets the current status of a swap transaction by its on-chain transaction hash. Use this to poll for completion after calling [`executeSwapTransaction`](/javascript/reference/client/execute-swap-transaction).

## Usage

```javascript theme={"system"}
import { getSwapStatus } from '@dynamic-labs-sdk/client';

const status = await getSwapStatus({
  txHash: '0x1234567890abcdef...',
  from: { chain: 'EVM', networkId: '1' },
  to: { chain: 'EVM', networkId: '137' },
});

console.log('Status:', status.status);
console.log('Substatus:', status.substatus);
```

## Parameters

| Parameter        | Type                       | Description                                                             |
| ---------------- | -------------------------- | ----------------------------------------------------------------------- |
| `txHash`         | `string`                   | The on-chain transaction hash from `executeSwapTransaction`.            |
| `from`           | `object` (optional)        | Source chain details.                                                   |
| `from.chain`     | `Chain`                    | The source chain (e.g., `'EVM'`, `'SOL'`).                              |
| `from.networkId` | `string`                   | The source network ID.                                                  |
| `to`             | `object` (optional)        | Destination chain details.                                              |
| `to.chain`       | `Chain`                    | The destination chain.                                                  |
| `to.networkId`   | `string`                   | The destination network ID.                                             |
| `client`         | `DynamicClient` (optional) | The Dynamic client instance. Only required when using multiple clients. |

## Returns

`Promise<SwapStatusResponse>` - The swap status:

```typescript theme={"system"}
type SwapStatusResponse = {
  status: SwapStatus;
  substatus?: SwapSubstatus | string;
};
```

## Status Values

| Status    | Description                 |
| --------- | --------------------------- |
| `PENDING` | Swap is in progress         |
| `DONE`    | Swap completed successfully |
| `FAILED`  | Swap failed                 |

## Substatus Values

**When pending:**

| Substatus                      | Description                               |
| ------------------------------ | ----------------------------------------- |
| `WAIT_SOURCE_CONFIRMATIONS`    | Waiting for source chain confirmations    |
| `WAIT_DESTINATION_TRANSACTION` | Waiting for destination chain transaction |
| `BRIDGE_NOT_AVAILABLE`         | Bridge temporarily unavailable            |
| `CHAIN_NOT_AVAILABLE`          | Chain temporarily unavailable             |
| `REFUND_IN_PROGRESS`           | Refund is being processed                 |
| `UNKNOWN_ERROR`                | Unknown pending error                     |

**When done:**

| Substatus   | Description         |
| ----------- | ------------------- |
| `COMPLETED` | Fully completed     |
| `PARTIAL`   | Partially completed |
| `REFUNDED`  | Funds were refunded |

**When failed:**

| Substatus                | Description                     |
| ------------------------ | ------------------------------- |
| `INSUFFICIENT_ALLOWANCE` | Token approval was insufficient |
| `INSUFFICIENT_BALANCE`   | Wallet had insufficient funds   |
| `OUT_OF_GAS`             | Transaction ran out of gas      |
| `EXPIRED`                | Swap route expired              |
| `SLIPPAGE_EXCEEDED`      | Slippage tolerance was exceeded |
| `UNKNOWN_FAILED_ERROR`   | Unknown failure                 |

## Examples

### Poll until complete

```javascript theme={"system"}
import { getSwapStatus } from '@dynamic-labs-sdk/client';

const waitForSwap = async (txHash, from, to) => {
  while (true) {
    const { status, substatus } = await getSwapStatus({
      txHash,
      from,
      to,
    });

    if (status === 'DONE') {
      console.log('Swap completed:', substatus);
      return { status, substatus };
    }

    if (status === 'FAILED') {
      throw new Error(`Swap failed: ${substatus}`);
    }

    // Wait 3 seconds before polling again
    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
};

const result = await waitForSwap(
  '0x1234...',
  { chain: 'EVM', networkId: '1' },
  { chain: 'EVM', networkId: '137' }
);
```

### Cross-chain status check

```javascript theme={"system"}
import {
  executeSwapTransaction,
  getSwapStatus,
} from '@dynamic-labs-sdk/client';

const { transactionHash } = await executeSwapTransaction({
  walletAccount,
  signingPayload: quote.signingPayload,
});

// For cross-chain swaps, provide both source and destination chain info
const status = await getSwapStatus({
  txHash: transactionHash,
  from: { chain: 'EVM', networkId: '1' },   // Ethereum
  to: { chain: 'EVM', networkId: '137' },    // Polygon
});

if (status.substatus === 'WAIT_DESTINATION_TRANSACTION') {
  console.log('Bridging in progress, waiting for destination chain...');
}
```

## React

`useGetSwapStatus` is a query hook. Pass `refetchInterval` to poll automatically:

```tsx theme={"system"}
import { useGetSwapStatus } from '@dynamic-labs-sdk/react-hooks';

function SwapProgress({ txHash }) {
  const { data: status, isLoading } = useGetSwapStatus({
    txHash,
    from: { chain: 'EVM', networkId: '1' },
    to: { chain: 'EVM', networkId: '137' },
    queryParams: { refetchInterval: 3000 },
  });

  if (isLoading) return <p>Checking status...</p>;
  if (status?.status === 'DONE') return <p>Swap complete!</p>;
  if (status?.status === 'FAILED') return <p>Swap failed: {status.substatus}</p>;

  return <p>Status: {status?.status} ({status?.substatus})</p>;
}
```

## Related

* [`executeSwapTransaction`](/javascript/reference/client/execute-swap-transaction) - Execute the swap on-chain
* [`getSwapQuote`](/javascript/reference/client/get-swap-quote) - Get a swap quote