Swaps - Whop Docs

Swaps convert value between supported tokens, chains, or wallet destinations for an account. A swap quote describes the expected output, fees, and approval requirements before you create the swap. Use the Swaps API to quote a conversion, create the swap, list recent swaps, and retrieve status until the transaction completes.

Endpoints

Endpoint	Request
List Swaps	GET `/swaps`
Retrieve Swap	GET `/swaps/{id}`
Create Swap	POST `/swaps`
Create Swap Quote	POST `/swaps/quote`

Attributes

string

required

Swap ID.

string

required

Account that owns the swap: a business ID prefixed biz_, or the user ID for a personal account.

string | null

Latest error returned for a failed swap.

string

required

string

required

Current swap status. complete and failed are terminal.Available options: queued, working, complete, failed

string[]

required

On-chain transaction hashes produced by the swap.

string | null

required

User whose personal account owns the swap, prefixed user_. Null for a business account.

Swap

{
	"id": "swap_xxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"error": null,
	"object": "swap",
	"status": "complete",
	"tx_hashes": ["0x1234567890abcdef"],
	"user_id": null
}

​Endpoints

​Attributes

Endpoints

Attributes