---
title: "List Swaps"
method: GET
path: "/swaps"
tags: ["Swaps"]
---

# List Swaps

`GET /swaps`

Retrieve the account's completed or pending swaps — currently just the latest one.

## Query parameters

- `account_id` string, required

## Response `200`

swaps listed

- object
  - `data` object[], required — Swaps returned for this account.
    - `account_id` string, required — Account ID that owns the wallet used for the swap.
    - `error` string, nullable — Latest error returned for a failed swap.
    - `id` string, required — Swap ID.
    - `object` 'swap', required
    - `status` 'queued' | 'working' | 'complete' | 'failed', required — Current swap status. `complete` and `failed` are terminal.
    - `tx_hashes` string[], required — On-chain transaction hashes produced by the swap.

## Other responses

- `403` — Forbidden

## Changes

> 69 revisions in range; 1 not diffed.

- **2026-09-23** `140d015b9966` — 2 info
  - the security scope `crypto_wallet:swap` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-22** `35edb053220a` — 2 info
  - the security scope `crypto_wallet:swap` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-21** `ac2b9b1c6a00` — 2 info
  - the security scope `crypto_wallet:swap` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-21** `a88353507eac` — 2 info
  - the security scope `crypto_wallet:swap` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-20** `51933d70d7f5` — 2 info
  - the security scope `crypto_wallet:swap` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `crypto_wallet:manage` was removed from the endpoint's security scheme `bearerAuth`

[Full history](https://skmtc.dev/whop/apis/whop-api/changes/swaps/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/140d015b9966?raw)