Swaps

A Swap converts value between supported tokens, chains, or wallet destinations, or between fiat currencies at the mid-market rate, for an account or user. A swap quote previews 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 a swap’s status until it 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
}

Introduction

Reference

Webhooks & Events

Core Resources

Payments

Money

Commerce

Websites

Ads

Analytics

Partners

Workforce

Chat

Media

Developer

Endpoints

Attributes

​Endpoints

​Attributes

Endpoints

Attributes