# 토큰 및 NFT 조회

### 계정 정보 조회 하기 <a href="#retrieve-account-information" id="retrieve-account-information"></a>

로그인이 성공적으로 완료된 이후에만 사용 가능한 기능입니다. 앱에서 사용하는 지갑의 계정 정보를 반환합니다.

```http
GET /v1/account?userId={userId}&walletId={walletId} HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}
```

#### Request

**Parameter**

<table><thead><tr><th width="136">Name</th><th width="105">Type</th><th width="371">Description</th><th>Required</th></tr></thead><tbody><tr><td>userId</td><td>String</td><td><a href="../login#login">로그인</a> 과정에서 받은 <code>userInfo</code>의 userId</td><td>O</td></tr><tr><td>walletId</td><td>String</td><td><a href="../login#login">로그인</a> 결과 받은 사용자 지갑 ID</td><td>O</td></tr></tbody></table>

#### Response

**Success Response**

<table><thead><tr><th width="145">Name</th><th width="204">Type</th><th>Description</th></tr></thead><tbody><tr><td>walletId</td><td>String</td><td>사용자 지갑 ID</td></tr><tr><td>accounts</td><td>Account(Object) []</td><td>조회 된 계정 리스트 (<code>Account</code>)</td></tr></tbody></table>

* `Account`

  * `accountId` *String*
    * 계정 고유 식별 번호
  * `accountTokenId` *String (Optional)*
    * 토큰 계정 고유 식별 번호. 토큰 계정인 경우에만 반환.
  * `address` *String*
    * 계정의 주소
  * `addressPath` *String*
    * 계정의 주소 경로
  * `label` *String*
    * 계정 라벨
  * `balance` *String*
    * 계정 잔액
  * `coinId` *Integer (Optional)*
    * 계정의 코인 정보 식별 번호. 네이티브 코인인 경우에만 반환.
  * `name` *String*
    * 계정의 코인 정보 이름
  * `network` *String*
    * 계정의 네트워크 이름
  * `symbol` *String*
    * 계정의 심볼
  * `decimals` *Integer*
    * 계정의 코인 데시멀 값
  * `contract` *String (Optional)*
    * 토큰 계정의 컨트랙트 주소. 토큰 계정인 경우에만 반환.
  * `iconUrl` *String*
    * 계정의 아이콘 이미지 URL
  * `ids` *String*
    * 계정의 코인 정보를 조회 하기 위한 식별 값

***Example***

```json
// Klaytn 메인 계정과 KCT(토큰) 계정이 있는 경우 
{
	"walletId": "999999999999999999999999999999999999999999999999999999999999999999",
  "accounts": [
    {
      "accountId": "90",
      "address": "0x9990000000000000000000000000000000000000",
      "addressPath": "m/44'/60'/0'/0/0",
      "coinId": 2,
      "symbol": "KLAY",
      "label": "KLAY-01",
      "name": "Klaytn",
      "network": "KLAYTN",
      "balance": "123407670918639753",
      "decimals": 18,
      "iconUrl": "<https://coin-img.wepin.io/coinlogo/klaytn.png>",
      "ids": "klay-token"
    },
    {
      "accountId": "90",
      "accountTokenId": "91",
      "address": "0x9990000000000000000000000000000000000000",
      "addressPath": "m/44'/60'/0'/0/0",
      "contract": "0x52CFDA3E278837d852C4315586C9464BE762647E",
      "symbol": "COSM",
      "label": "COSM",
      "name": "Cosmo Coin",
      "network": "KLAYTN",
      "balance": "20000000000000000",
      "decimals": 18,
      "iconUrl": "<https://coin-img.wepin.io/coinlogo/cosmo.png>",
      "ids": "cosmo-coin"
    }
  ]
}
```

***

### 계정 잔액 새로 고침 <a href="#refresh-account-balance" id="refresh-account-balance"></a>

계정의 잔액을 새로 고침 합니다. Front 서비스에서 새로 고침을 사용자의 요청에 의해 수행하는 경우, 1분 이내에 다시 요청하지 않도록 UI/UX를 제공할 것을 권장합니다.

```http
GET /v1/accountbalance/{accountId}/balance HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}
```

#### Request

**Parameter**

<table><thead><tr><th width="143">Name</th><th width="120">Type</th><th width="366">Description</th><th>Required</th></tr></thead><tbody><tr><td>accountId</td><td>String</td><td><a href="#undefined">계정 정보 조회</a> 시 받은 accountId</td><td>O</td></tr></tbody></table>

#### Response

**Success Response**

<table><thead><tr><th width="223">Name</th><th width="278">Type</th><th>Description</th></tr></thead><tbody><tr><td>balance</td><td>String</td><td>계정 잔액</td></tr><tr><td>decimals</td><td>Integer</td><td>계정의 데시멀 값</td></tr><tr><td>symbol</td><td>String</td><td>계정의 심볼</td></tr><tr><td>tokens</td><td>TokenBalance(Object) []</td><td>계정 토큰들의 잔액 리스트 (<code>TokenBalance</code>)</td></tr></tbody></table>

* `TokenBalance`

  * `balance` *String*
    * 토큰 계정 잔액
  * `decimals` *Integer*
    * 토큰 계정 데이멀 값
  * `symbol` *String*
    * 토큰 계정의 심볼
  * `contract` *String*
    * 토큰 계정의 컨트랙트 주소

***Example***

```json
{
	"balance": "123407670918639753",
  "decimals": 18,
  "symbol": "KLAY",
  "tokens": [
		{
		  "balance": "20000000000000000",
			"decimals": 18,
			"symbol": "COSM",
			"contract": "0x52CFDA3E278837d852C4315586C9464BE762647E"
		}
	]
}
```

***

### NFT 정보 조회 하기 <a href="#retrieve-nft-information" id="retrieve-nft-information"></a>

로그인이 성공적으로 완료된 이후에만 사용 가능한 기능입니다. 앱에서 사용하는 지갑의 NFT 정보를 반환합니다.

```http
GET /v1/nft?userId={userId}&walletId={walletId} HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}
```

#### Request

**Parameter**

<table><thead><tr><th width="144">Name</th><th width="99">Type</th><th width="401">Description</th><th>Required</th></tr></thead><tbody><tr><td>userId</td><td>String</td><td><a href="../login#login">로그인</a> 과정에서 받은 <code>userInfo</code>의 userId</td><td>O</td></tr><tr><td>walletId</td><td>String</td><td><a href="../login#login">로그인</a> 결과 받은 사용자 지갑 ID</td><td>O</td></tr></tbody></table>

#### Response

**Success Response**

<table><thead><tr><th width="140">Name</th><th width="203">Type</th><th>Description</th></tr></thead><tbody><tr><td>nfts</td><td>NFT(Object) []</td><td>조회 된 NFT 리스트 (<code>NFT</code>)</td></tr></tbody></table>

* `NFT`

  * `id` *String*
    * NFT 고유 식별 번호
  * `accountId` *String*
    * NFT 가 있는 계정 고유 식별 번호
  * `name` *String*
    * NFT 이름
  * `description` *String*
    * NFT 설명
  * ### `tokenId` *String*
  * `externalLink` *String*
    * NFT 외부 링크
  * `imageUrl` *String*
    * NFT 이미지 URL
  * `quantity` *Integer*
    * NFT 개수
  * `contentType` *Integer*
    * NFT 컨텐츠의 종류
    * `1` : image
    * `2` : video
  * `contract` *Object*
    * NFT contract 의 정보 (`NFTContract`)

  *Example*

  ```json
  {
  	"nfts": []
  }
  ```
* `NFTContract`
  * `address` *String*
    * NFT Contract address
  * `scheme` *Integer*
    * NFT Contract Scheme
    * `1` : ERC721
    * `2` : ERC1155
  * `description` *String*
    * NFT Contract 설명
  * `network` *String*
    * 네트워크
  * `externalLink` *String*
    * NFT Contract 외부 링크
  * `imageUrl` *String*
    * NFT Contract 이미지 URL

### NFT 정보 새로 고침 <a href="#refresh-nft-information" id="refresh-nft-information"></a>

NFT 정보를 새로 고침 합니다. Front 서비스에서 새로 고침을 사용자의 요청에 의해 수행하는 경우, 1분 이내에 다시 요청하지 않도록 UI/UX 를 제공할 것을 권장합니다.

```http
GET /v1/nft/refresh?userId={userId}&walletId={walletId} HTTP/1.1
Host: sdk.wepin.io
X-API-KEY: ${APP_KEY}
X-API-DOMAIN: {APP_DOMAIN}
X-SDK-TYPE: {platform}_rest_api
Content-Type: application/json
Authorization: Bearer ${access_token}
```

#### Request

**Parameter**

<table><thead><tr><th width="124">Name</th><th width="100">Type</th><th width="413">Description</th><th>Required</th></tr></thead><tbody><tr><td>userId</td><td>String</td><td><a href="../login#login">로그인</a> 과정에서 받은 <code>userInfo</code> 의 userId</td><td>O</td></tr><tr><td>walletId</td><td>String</td><td><a href="../login#login">로그인</a> 결과 받은 사용자 지갑 ID</td><td>O</td></tr></tbody></table>

#### Response

[NFT 정보 조회 하기](#nft) Response 와 동일 합니다.