# Token

토큰 관련 API

## 지원 토큰 목록

> 시스템에서 지원하는 모든 토큰 목록을 조회합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Token","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/token/supported":{"post":{"tags":["Token"],"summary":"지원 토큰 목록","description":"시스템에서 지원하는 모든 토큰 목록을 조회합니다","parameters":[{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string","default":"TEST_API_KEY"},"description":"API Key"}],"responses":{"200":{"description":"토큰 목록 조회 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Token"}}}}}}},"401":{"description":"인증 실패"}}}}},"components":{"schemas":{"Token":{"type":"object","properties":{"id":{"type":"number"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"},"cmcId":{"type":"number"},"coingeckoId":{"type":"string"},"binanceSymbol":{"type":"string"},"isActive":{"type":"boolean"}}}}}}
```

## 토큰 가격 조회

> 특정 토큰의 현재 가격을 조회합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Token","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/token/token-price/{symbol}":{"post":{"tags":["Token"],"summary":"토큰 가격 조회","description":"특정 토큰의 현재 가격을 조회합니다","parameters":[{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string","default":"TEST_API_KEY"},"description":"API Key"},{"in":"path","name":"symbol","required":true,"schema":{"type":"string"},"description":"토큰 심볼"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"quote":{"type":"string","default":"USDT","description":"기준 통화"},"invalidate":{"type":"boolean","default":false,"description":"캐시 무효화 여부"}}}}}},"responses":{"200":{"description":"가격 조회 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"object","properties":{"symbol":{"type":"string"},"price":{"type":"string"},"quote":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}}}}}}}},"401":{"description":"인증 실패"},"404":{"description":"토큰을 찾을 수 없음"}}}}}}
```

## 사용자 토큰 잔액 조회

> UUID로 사용자의 토큰 잔액을 조회합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Token","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/token/user-balances":{"post":{"tags":["Token"],"summary":"사용자 토큰 잔액 조회","description":"UUID로 사용자의 토큰 잔액을 조회합니다","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","default":"40115395-195e-4c14-b5f4-261f13da353e"}}}}}},"responses":{"200":{"description":"잔액 조회 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"balance":{"type":"string"},"decimals":{"type":"number"}}}}}}}}},"401":{"description":"인증 실패"},"404":{"description":"사용자를 찾을 수 없음"}}}}}}
```

## 토큰 가격 캔들 차트

> 특정 토큰의 가격 캔들 차트 데이터를 조회합니다

```json
{"openapi":"3.0.0","info":{"title":"Tikkly B2C API","version":"0.0.1"},"tags":[{"name":"Token","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/token/token-price-candles/{symbol}":{"post":{"tags":["Token"],"summary":"토큰 가격 캔들 차트","description":"특정 토큰의 가격 캔들 차트 데이터를 조회합니다","parameters":[{"in":"header","name":"x-api-key","required":true,"schema":{"type":"string","default":"TEST_API_KEY"},"description":"API Key"},{"in":"path","name":"symbol","required":true,"schema":{"type":"string"},"description":"토큰 심볼"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["interval"],"properties":{"interval":{"type":"string","enum":["1m","5m","15m","30m","1h","4h","1d","1w","1M"],"description":"캔들 간격"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":100,"description":"반환할 캔들 개수"},"quote":{"type":"string","default":"USDT","description":"기준 통화"}}}}}},"responses":{"200":{"description":"캔들 데이터 조회 성공","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Candle"}}}}}}},"401":{"description":"인증 실패"},"404":{"description":"토큰을 찾을 수 없음"}}}}},"components":{"schemas":{"Candle":{"type":"object","properties":{"time":{"type":"number","description":"Unix timestamp in milliseconds"},"open":{"type":"string"},"high":{"type":"string"},"low":{"type":"string"},"close":{"type":"string"},"volume":{"type":"string"}}}}}}
```