# Token and NFT

### Retrieve Account Information <a href="#retrieve-account-information" id="retrieve-account-information"></a>

This feature is available only after a successful login. It returns the account information for wallets used in the app.

```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><code>userId</code> obtained from the <code>userInfo</code> during the <a href="/pages/EQaogmCNNR1GmRx6oihQ#login">Login</a> process.</td><td>O</td></tr><tr><td>walletId</td><td>String</td><td>Wallet ID received as a result of the <a href="/pages/EQaogmCNNR1GmRx6oihQ#login">Login</a>.</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>The user's wallet ID.</td></tr><tr><td>accounts</td><td>Account(Object) []</td><td>List of retrieved accounts (<code>Account</code>)</td></tr></tbody></table>

* `Account`

  * `accountId` *String*
    * Unique identifier for the account
  * `accountTokenId` *String (Optional)*
    * Unique identifier for the token account. Returned only if it is a token account.
  * `address` *String*
    * Account address
  * `addressPath` *String*
    * Account address path
  * `label` *String*
    * Account label
  * `balance` *String*
    * Account balance
  * `coinId` *Integer (Optional)*
    * Identifier for the coin information of the account. Returned only for native coins.
  * `name` *String*
    * Name of the coin information of the account
  * `network` *String*
    * Network name of the account
  * `symbol` *String*
    * Symbol of the account
  * `decimals` *Integer*
    * Decimal value of the coin in the account
  * `contract` *String (Optional)*
    * Contract address of the token account. Returned only for token accounts.
  * `iconUrl` *String*
    * URL for the account's icon image
  * `ids` *String*
    * Identifier to retrieve the coin information of the account

***Example***

```json
// When there is a Klaytn main account and KCT (token) accounts
{
	"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"
    }
  ]
}
```

***

### Refresh Account Balance <a href="#refresh-account-balance" id="refresh-account-balance"></a>

Refreshes the balance of the account. If the refresh is triggered by the user in the front-end service, it is recommended to implement UI/UX to prevent repeated requests within 1 minute.

```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>accountId received from the <a href="#retrieve-account-information">account information retrieval</a></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>Account balance</td></tr><tr><td>decimals</td><td>Integer</td><td>Decimal value of the account</td></tr><tr><td>symbol</td><td>String</td><td>Symbol of the account</td></tr><tr><td>tokens</td><td>TokenBalance(Object) []</td><td>List of balances for the account's tokens (<code>TokenBalance</code>)</td></tr></tbody></table>

* `TokenBalance`
  * `balance` *String*
    * Token account balance
  * `decimals` *Integer*
    * Decimal value of the token account
  * `symbol` *String*
    * Symbol of the token account
  * `contract` *String*
    * Contract address of the token account

***Example***

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

***

### Retrieve NFT Information <a href="#retrieve-nft-information" id="retrieve-nft-information"></a>

This function is available only after a successful login. It returns the NFT information of the wallet used in the app.

```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><code>userId</code> obtained from the <code>userInfo</code> during the <a href="/pages/EQaogmCNNR1GmRx6oihQ#login">Login</a> process.</td><td>O</td></tr><tr><td>walletId</td><td>String</td><td>Wallet ID received as a result of the <a href="/pages/EQaogmCNNR1GmRx6oihQ#login">Login</a>.</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>Retrieved NFT list (<code>NFT</code>)</td></tr></tbody></table>

* `NFT`

  * `id` *String*
    * Unique identifier of the NFT
  * `accountId` *String*
    * Unique identifier of the account holding the NFT
  * `name` *String*
    * NFT name
  * `description` *String*
    * NFT description
  * ### `tokenId` *String*
  * `externalLink` *String*
    * NFT external link
  * `imageUrl` *String*
    * NFT image URL
  * `quantity` *Integer*
    * Number of NFTs
  * `contentType` *Integer*
    * Type of NFT content
    * `1` : image
    * `2` : video
  * `contract` *Object*
    * Information about the 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*
    * Network
  * `externalLink` *String*
    * NFT contract external link
  * `imageUrl` *String*
    * NFT contract image URL

### Refresh NFT Information <a href="#refresh-nft-information" id="refresh-nft-information"></a>

Refreshes the NFT information. If the refresh is triggered by a user's request in the front-end service, it is recommended to design the UI/UX to prevent repeated requests within 1 minute.

```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><code>userId</code> obtained from the <code>userInfo</code> during the <a href="/pages/EQaogmCNNR1GmRx6oihQ#login">Login</a> process.</td><td>O</td></tr><tr><td>walletId</td><td>String</td><td>Wallet ID received as a result of the <a href="/pages/EQaogmCNNR1GmRx6oihQ#login">Login</a>.</td><td>O</td></tr></tbody></table>

#### Response

The response is identical to that of [Retrieve NFT Information](#retrieve-nft-information).


---

# 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://docs.wepin.io/en/api/token-and-nft.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.