> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Swaps API

> Swap은 계정 또는 사용자를 위해 지원되는 토큰, 체인 또는 지갑 대상 간에 가치를 변환하거나, 중간 시장 환율로 법정 통화 간에 변환합니다.

스왑 견적을 사용하면 스왑을 생성하기 전에 예상 결과물, 수수료, 승인 요구 사항을 미리 확인할 수 있습니다.

Swaps API를 사용하면 변환 견적을 받고, 스왑을 생성하고, 최근 스왑 목록을 조회하고, 스왑이 완료될 때까지 상태를 조회할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [스왑 목록 조회](https://docs.whop.com/ko/api-reference/swaps/list-swaps.md) | GET `/swaps` |
| [스왑 조회](https://docs.whop.com/ko/api-reference/swaps/retrieve-swap.md) | GET `/swaps/{id}` |
| [스왑 생성](https://docs.whop.com/ko/api-reference/swaps/create-swap.md) | POST `/swaps` |
| [스왑 견적 생성](https://docs.whop.com/ko/api-reference/swaps/create-swap-quote.md) | POST `/swaps/quote` |

## 속성

**id** `string` *required*

스왑 ID입니다.

**account\_id** `string` *required*

스왑을 소유한 계정입니다. `biz_` 접두사가 붙은 비즈니스 ID이거나, 개인 계정의 경우
사용자 ID입니다.

**amount** `string | null` *required*

스왑 생성 시 지출하도록 지정된 from\_token 금액으로, 십진수 문자열입니다.
`all`로 생성된 스왑은 읽어 들인 지갑 잔액을 보고합니다. 법정 통화 쌍의 경우
null입니다.

**error** `string | null`

실패한 스왑에 대해 반환된 최신 오류입니다.

**object** `string` *required*

**status** `string` *required*

현재 스왑 상태입니다. `complete`와 `failed`는 최종 상태입니다.

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

**tx\_hashes** `string[]` *required*

스왑으로 생성된 온체인 트랜잭션 해시입니다.

**user\_id** `string | null` *required*

스왑을 소유한 개인 계정의 사용자로, `user_` 접두사가 붙습니다. 비즈니스 계정의 경우
null입니다.

```json Swap theme={null}
{
	"id": "swap_xxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"amount": "0.052341",
	"error": null,
	"object": "swap",
	"status": "complete",
	"tx_hashes": ["0x1234567890abcdef"],
	"user_id": null
}
```


## Related topics

- [List Swaps](https://docs.whop.com/ko/api-reference/swaps/list-swaps.md)
- [Retrieve Swap](https://docs.whop.com/ko/api-reference/swaps/retrieve-swap.md)
- [Create Swap](https://docs.whop.com/ko/api-reference/swaps/create-swap.md)
