> For the complete documentation index, see [llms.txt](https://osige.gitbook.io/osige-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://osige.gitbook.io/osige-docs/ko/trading/swap.md).

# 스왑 (Swap)

스왑은 하나 이상의 유동성 풀을 거쳐 한 토큰을 다른 토큰으로 바꾸는 거래입니다.\
Osige가 트랜잭션을 준비하면 연결된 지갑이 서명해 GIWA에 제출합니다.

<figure><img src="/files/LdR4Q1CkjgqfZWUl85T6" alt="매도/매수 토큰 입력, 슬리피지, 지갑 액션이 있는 Osige 스왑 패널"><figcaption><p>매도/매수 토큰 입력, 슬리피지, 지갑 액션이 있는 Osige 스왑 패널</p></figcaption></figure>

## 트레이드 워크스페이스

[Trade 페이지](https://osige.exchange/trade)는 단순한 스왑 폼이 아닌 하나의 작업공간입니다.\
주문 패널 주변에 다음 도킹 패널을 자유롭게배치할 수 있습니다

* **Chart:** 선택한 마켓의 캔들 차트와 TradingView 스타일 차트
* **Holders:** 선택한 토큰의 보유자 현황
* **Community:** 해당 마켓에 대한 커뮤니티
* **Market:** 풀에서 일어난 최신 스왑

패널을 드래그해 원하는 레이아웃으로 옮길 수 있습니다.

## 스왑 실행하기

1. 지불할 토큰과 받을 토큰을 선택합니다
2. 수량을 입력하면 Osige가 가능한 최적 경로로 견적을 냅니다
3. 견적 아래의 상세 내용을 확인합니다(아래 설명 참고)
4. 지갑이 요청하면 입력 토큰 Approval을 승인하세요. 승인은 별도의 권한 부여 트랜잭션입니다
5. **Swap**을 선택하고 확인을 누릅니다
6. [GIWA 익스플로러](https://sepolia-explorer.giwa.io)에서 최종 상태를 확인하세요

## 견적 이해하기

<figure><img src="/files/5acyQZqT15szt4Gwkid4" alt=""><figcaption><p>Osige Swap 견적</p></figcaption></figure>

**경로(Route):** 입력 토큰을 출력 토큰으로 바꾸기 위해 거치는 풀의 순서입니다. 직접 경로는 풀 하나만 사용합니다 (1 hop route). 더 나은 결과가 예상되면 여러 풀을 거치거나 거래를 여러 경로로 나눌 수도 있습니다. 경로의 각 풀은 자체 LP 수수료와 훅 정책을 적용하므로 서명 전에 전체 경로를 확인하세요.

**수수료:** 세 가지 비용이 각각 적용될 수 있습니다

* *LP 수수료* — 경로의 각 풀이 부과해 해당 풀의 유동성 공급자에게 지급합니다. 풀은 고정 수수료를 쓰거나 훅이 정한 동적 수수료를 쓸 수 있습니다(예: `up.id` 할인 — [아이덴티티 기능](/osige-docs/ko/osige-features/identity.md) 참고)
* *프로토콜 수수료* — 스왑 수수료 가운데 별도로 설정된 몫이며, 풀마다 다릅니다
* *네트워크 수수료(가스)* — GIWA Sepolia에 ETH로 내는 비용으로 Osige와 무관합니다

**가격 영향(Price impact):** 내 거래가 풀 가격을 얼마나 움직일지 나타내는 추정치입니다. 유동성이 얕을수록, 거래가 클수록 영향도 커집니다. 유동성이 제한된 테스트넷에서는 가격영향이 크게 발생할 수 있습니다

**최소 수령량 / 최대 지불량 (Minimum received):** 트랜잭션이 되돌려지기(revert) 전까지 허용하는 최악의 체결 조건입니다. 이 경계는 슬리피지 허용치에서 정합니다.

**슬리피지 (Slippage) 허용치:** 체결이 견적에서 얼마나 벗어나도 되는지를 정하는 값입니다. 수수료가 아니라 보호 장치입니다:

* 너무 낮으면 — 정상적인 가격 변동에도 트랜잭션이 실패합니다;
* 너무 높으면 — 예상보다 크게 불리한 가격에 체결될 수 있습니다.

주문 패널의 설정 아이콘에서 조절할 수 있습니다. 현재 시장 상황에 맞는 가장 낮은 값을 쓰세요.

## 스왑이 실패한다면

흔한 원인 순서대로

* 견적이 만료됐거나 가격이 슬리피지 한도를 넘어 움직임. 견적을 새로 받은 뒤 재시도
* 토큰 approval 이 없거나 승인량이 부족함
* 토큰 잔고나 가스 ETH 부족
* 지갑 네트워크가 잘못됨 (GIWA Sepolia, `91342`여야 함)
* 경로상 유동성 부족
* 풀 훅이 액션을 거부함
* RPC 또는 지갑 연결 문제

실패한 트랜잭션도 가스를 소모할 수 있습니다. 재제출하기 전에 오류와 이전 트랜잭션 상태를 확인하세요.

더 많은 사례는 [FAQ와 문제 해결](/osige-docs/ko/reference/faq.md)에서 확인할 수 있습니다.

{% hint style="info" %}
차트 데이터와 마켓 카드는 각자의 주기로 갱신되는 표시용 화면입니다. 실제 체결의 기준은 주문 패널의 견적입니다.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://osige.gitbook.io/osige-docs/ko/trading/swap.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
