# 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":"인증 실패"}}}}}}
```