Skip to main content
GET
TypeScript

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

crypto_wallet:swap
crypto_wallet:manage
payout:transfer_funds
payout:withdraw_funds

헤더

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

Swap ID returned from POST /swaps.

응답

swap status retrieved

account_id
string
필수

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

예시:

"biz_xxxxxxxxxxxxxx"

amount
string | null
필수

The from_token amount the swap was created to spend, as a decimal string. A swap created with all reports the wallet balance it read. Null for a fiat pair.

예시:

"0.052341"

id
string
필수

Swap ID.

예시:

"vault-swap-cwal_xxxxxxxxxxxxxx"

object
enum<string>
필수
사용 가능한 옵션:
swap
예시:

"swap"

status
enum<string>
필수

Current swap status. complete and failed are terminal.

사용 가능한 옵션:
queued,
working,
complete,
failed
예시:

"failed"

tx_hashes
string[]
필수

On-chain transaction hashes produced by the swap.

user_id
string | null
필수

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

예시:

null

error
string | null

Latest error returned for a failed swap.

예시:

"Swap reverted: quoted price moved beyond the slippage tolerance"