# Exchange

포인트 교환 관련 API

## 포인트를 코인으로 전환

> 포인트를 암호화폐로 전환합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Exchange","description":"포인트 교환 관련 API"}],"servers":[{"url":"https://api-b2c.tikkly.io","description":"Development Server (Active)"},{"url":"https://api.tikkly.com","description":"Production Server"},{"url":"http://localhost:8081","description":"Local Development Server"}],"paths":{"/tikkly-b2c/exchange/convert-point-to-coin":{"post":{"tags":["Exchange"],"summary":"포인트를 코인으로 전환","description":"포인트를 암호화폐로 전환합니다","parameters":[{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string","default":"TEST_API_KEY"},"description":"API Key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uuid","symbol","cexType","pointAmount","pointType"],"properties":{"uuid":{"type":"string","description":"사용자 UUID"},"symbol":{"type":"string","description":"토큰 심볼"},"cexType":{"type":"string","description":"거래소 타입"},"pointAmount":{"type":"string","description":"포인트 수량"},"pointType":{"type":"string","description":"포인트 타입"}}}}}},"responses":{"200":{"description":"전환 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"object","properties":{"orderId":{"type":"string"}}}}}}}},"401":{"description":"인증 실패"}}}}}}
```

## 전환 견적 조회

> 포인트를 코인으로 전환할 때의 예상 견적을 조회합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Exchange","description":"포인트 교환 관련 API"}],"servers":[{"url":"https://api-b2c.tikkly.io","description":"Development Server (Active)"},{"url":"https://api.tikkly.com","description":"Production Server"},{"url":"http://localhost:8081","description":"Local Development Server"}],"paths":{"/tikkly-b2c/exchange/convert-quote":{"post":{"tags":["Exchange"],"summary":"전환 견적 조회","description":"포인트를 코인으로 전환할 때의 예상 견적을 조회합니다","parameters":[{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string","default":"TEST_API_KEY"},"description":"API Key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["symbol","cexType","pointAmount","pointType"],"properties":{"symbol":{"type":"string","description":"토큰 심볼"},"cexType":{"type":"string","description":"거래소 타입"},"pointAmount":{"type":"string","description":"포인트 수량"},"pointType":{"type":"string","description":"포인트 타입"}}}}}},"responses":{"200":{"description":"견적 조회 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"object","properties":{"fromAsset":{"type":"string"},"toAsset":{"type":"string"},"fromAmount":{"type":"string"},"toAmount":{"type":"string"},"ratio":{"type":"string"},"price":{"type":"string"}}}}}}}},"401":{"description":"인증 실패"}}}}}}
```

## 전환 내역 조회

> 사용자의 포인트 전환 내역을 조회합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Exchange","description":"포인트 교환 관련 API"}],"servers":[{"url":"https://api-b2c.tikkly.io","description":"Development Server (Active)"},{"url":"https://api.tikkly.com","description":"Production Server"},{"url":"http://localhost:8081","description":"Local Development Server"}],"paths":{"/tikkly-b2c/exchange/convert-quote-history":{"post":{"tags":["Exchange"],"summary":"전환 내역 조회","description":"사용자의 포인트 전환 내역을 조회합니다","parameters":[{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string","default":"TEST_API_KEY"},"description":"API Key"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["uuid"],"properties":{"uuid":{"type":"string","description":"사용자 UUID"},"since":{"type":"number","description":"시작 시간 (Unix timestamp, 0 = 전체)"},"until":{"type":"number","description":"종료 시간 (Unix timestamp, 0 = 전체)"}}}}}},"responses":{"200":{"description":"내역 조회 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"orderId":{"type":"string"},"pointType":{"type":"string"},"pointAmount":{"type":"string"},"fromAsset":{"type":"string"},"toAsset":{"type":"string"},"fromAmount":{"type":"string"},"toAmount":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}}}}}}}},"401":{"description":"인증 실패"}}}}}}
```


---

# Agent Instructions: 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:

```
GET https://guide.tikkly.io/exchange.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
