---
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

- **2026-08-16** `c363cb2feb95` — 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-08-15** `c301132dbfd7` — 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-08-14** `a84d4905fdbb` — 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-08-13** `48408451a1f0` — 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-08-12** `ae20b30817de` — 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-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/c363cb2feb95/schema)