# Wallet API

AUTHORIZATION - <mark style="color:red;">Bearer Token</mark>

This folder is using Bearer Token

~~**-------------------------------------------------------------------------------------------------**~~

## Domain Code

### Wallet Type&#x20;

| Type                           | Domain Code | desc                |
| ------------------------------ | ----------- | ------------------- |
| WALLET\_TYPE\_HD\_WALLET       | 1002001     | HD Wallet(Internal) |
| WALLET\_TYPE\_EXTERNAL\_WALLET | 1002002     | External wallet     |

### **NFTs Supported**

| Type                               | Domain Code | desc                   |
| ---------------------------------- | ----------- | ---------------------- |
| OWNER\_OF\_IN\_STOCK               | 1005001     | NFT in stock           |
| OWNER\_OF\_FOR\_SALE               | 1005002     | NFT for sale           |
| OWNER\_OF\_SOLD\_OUT               | 1005003     | NFT sold out           |
| OWNER\_OF\_BURN                    | 1005004     | NFT burned             |
| OWNER\_OF\_EXTERNAL\_TRANSFER\_OUT | 1005005     | NFT external withdrawl |

### NFTs Type&#x20;

| Type               | Domain Code | desc              |
| ------------------ | ----------- | ----------------- |
| NFT\_TYPE\_GAME    | 1015001     | NFT of game       |
| NFT\_TYPE\_BASIC   | 1015002     | NFT of gallery    |
| NFT\_TYPE\_SPECIAL | 1015003     | NFT of membership |

## <mark style="color:blue;">**GET**</mark>

~~*---------------------------------------------------------------------------------------------------*~~

## Search - Wallet List

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets`

[Wallet Type](#wallet-type)

List of wallets mapped to ssess

#### Query Parameters

| Name     | Type | Description |
| -------- | ---- | ----------- |
| pageNo   | Int  | default: 1  |
| pageSize | Int  | default: 20 |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "paging": {
            "pageNo": 1,
            "pageSize": 20,
            "totalCount": 1,
            "hasMore": false
        },
        "items": [
            {
                "wid": 10003,
                "createKst": 1648447308677,
                "updateKst": 1648465431990,
                "fid": 2517,
                "walletTypeDcd": "1002001",
                "walletType": "HD wallet",
                "walletAddress": "0xc8B26ef06FFEd6711Cf9deCE1cfB28fEC8209dcA",
                "walletIndex": 0,
                "walletNm": "11134r52as1",
                "chainId": 1,
                "displayOrd": 1,
                "displayYn": "Y",
                "bookmarkYn": "N",
                "externalServiceProviderDcd": null,
                "externalServiceProvider": null,
                "useGame": false,
                "totalCubeBalance": 0,
                "displayTotalCubeBalance": "0",
                "nftCount": 0
            }            
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Search - Wallet detail by Wallet Id (wid)

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}`

#### Path Parameters

| Name                                  | Type | Description |
| ------------------------------------- | ---- | ----------- |
| wid<mark style="color:red;">\*</mark> | Int  | wallet id   |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "items": [
            {
                "wid": 10003,
                "createKst": 1648447308677,
                "updateKst": 1648465431990,
                "fid": 2517,
                "walletTypeDcd": "1002001",
                "walletType": "HD wallet",
                "walletAddress": "0xc8B26ef06FFEd6711Cf9deCE1cfB28fEC8209dcA",
                "walletIndex": 0,
                "walletNm": "11134r52as1",
                "chainId": 1,
                "displayOrd": 1,
                "displayYn": "Y",
                "bookmarkYn": "N",
                "externalServiceProviderDcd": null,
                "externalServiceProvider": null,
                "useGame": false,
                "totalCubeBalance": 0,
                "displayTotalCubeBalance": "0",
                "nftCount": 0
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Search - Wallet Total Balance by Wallet Id (the market price)

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/balance`

Inquire the conversion amount of all assets held in the wallet (USD, KRW)

#### Path Parameters

| Name                                  | Type | Description |
| ------------------------------------- | ---- | ----------- |
| wid<mark style="color:red;">\*</mark> | Int  | wallet id   |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "items": [
            {
                "wid": 10003,
                "totalUsdPrice": 608.78505714431880330285018333,
                "displayTotalUsdPrice": "608.79",
                "totalKrwPrice": 829030.05549596757417337327744428,
                "displayTotalKrwPrice": "829,030"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Search - assets for Dashboard

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/assets-all`

Inquire information such as quantity and conversion amount of all assets held in the wallet

**Search Guide** - one of the list

1./v1/wallets/:wid/assets-all?fncyYn=Y\&cubeYn=N\&gcoinYn=N\&defaultYn=Y 2./v1/wallets/:wid/assets-all?fncyYn=N\&cubeYn=Y\&gcoinYn=N\&defaultYn=Y 3./v1/wallets/:wid/assets-all?fncyYn=Y\&cubeYn=N\&gcoinYn=Y\&defaultYn=Y 4./v1/wallets/:wid/assets-all?fncyYn=N\&cubeYn=Y\&gcoinYn=Y\&defaultYn=Y 5./v1/wallets/:wid/assets-all?fncyYn=N\&cubeYn=N\&gcoinYn=N\&defaultYn=Y 6./v1/wallets/:wid/assets-all?fncyYn=N\&cubeYn=N\&gcoinYn=N\&defaultYn=N

#### Path Parameters

| Name                                  | Type | Description |
| ------------------------------------- | ---- | ----------- |
| wid<mark style="color:red;">\*</mark> | Int  | wallet id   |

#### Query Parameters

| Name      | Type   | Description |
| --------- | ------ | ----------- |
| fncyYn    | String | Y \| N      |
| cubeYn    | String | Y \| N      |
| gcoinYn   | String | Y \| N      |
| defaultYn | String | Y \| N      |
| pageNo    | Int    | default: 1  |
| pageSize  | Int    | default: 20 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "paging": {
            "pageNo": 1,
            "pageSize": 20,
            "totalCount": 1,
            "hasMore": false
        },
        "items": [
            {
                "chainId": 3,
                "assetSeq": 2378,
                "wid": 10003,
                "assetId": 6,
                "assetOrd": 20,
                "displayYn": "Y",
                "balance": 336624855718900000000,
                "balancePlainString": "336624855718900000000",
                "displayBalance": "336.6248",
                "assetInfo": {
                    "assetId": 6,
                    "chainId": 3,
                    "chainNm": "FNCY",
                    "assetTypeDcd": "1004001",
                    "assetType": "Coin",
                    "contractAddress": "",
                    "assetNm": "FNCY",
                    "assetSymbol": "FNCY",
                    "assetSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/FNCY.png",
                    "assetDecimal": 18,
                    "fncyYn": "Y",
                    "cubeYn": "N",
                    "gcoinYn": "N",
                    "defaultAssetYn": "Y",
                    "gameCode": null,
                    "assetButtonTypeDcd": "1011013",
                    "assetButtonType": "COIN(FNCY)"
                },
                "prices": {
                    "btcPrice": 0,
                    "displayBtcPrice": "0",
                    "ethPrice": 0,
                    "displayEthPrice": "0",
                    "usdPrice": 0,
                    "displayUsdPrice": "0",
                    "krwPrice": 0,
                    "displayKrwPrice": "0"
                },
                "gameCode": null,
                "gameNm": null,
                "marketId": null,
                "publishedYn": null
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Search - User wallet asset

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/assets/{assetId}`

#### Path Parameters

| Name                                      | Type | Description                 |
| ----------------------------------------- | ---- | --------------------------- |
| wid<mark style="color:red;">\*</mark>     | Int  | wallet id                   |
| assetId<mark style="color:red;">\*</mark> | Int  | asset id you want to search |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "items": [
            {
                "chainId": 1,
                "assetSeq": 10,
                "wid": 10003,
                "assetId": 2,
                "assetOrd": 2,
                "displayYn": "Y",
                "balance": 1030091613676445059,
                "balancePlainString": "1030091613676445059",
                "displayBalance": "1.030091613676445059",
                "assetInfo": {
                    "assetId": 2,
                    "chainId": 1,
                    "chainNm": "BNB Smart Chain(BNB)",
                    "assetTypeDcd": "1004001",
                    "assetType": "Coin",
                    "contractAddress": "",
                    "assetNm": "Binance Coin",
                    "assetSymbol": "BNB",
                    "assetSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/BNB.png",
                    "assetDecimal": 18,
                    "fncyYn": null,
                    "cubeYn": "N",
                    "gcoinYn": "N",
                    "defaultAssetYn": "Y",
                    "gameCode": null,
                    "assetButtonTypeDcd": "1011004",
                    "assetButtonType": "COIN(BSC)"
                },
                "prices": {
                    "btcPrice": 0E-26,
                    "displayBtcPrice": "0",
                    "ethPrice": 0E-26,
                    "displayEthPrice": "0",
                    "usdPrice": 323.98534025196428530285018333,
                    "displayUsdPrice": "323.99",
                    "krwPrice": 441196.08600483797455537327744428,
                    "displayKrwPrice": "441,196"
                },
                "gameCode": null,
                "gameNm": null,
                "marketId": null,
                "publishedYn": null
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## Search - List of NFT

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/nfts`

[List of NFTs Supported](#list-of-nfts-supported)

[NFTs Type](#nfts-type)

**Search Guide**

1.Full NFT search by NFTs type

-nftType: \[game | basic | special]

-ownerOf: ""

2."in stokc" NFT Search by NFTs type

-nftType: \[game | basic | special]

-ownerOf: "instock"

3."for sale" NFT Search by NFTs type

-nftType: \[game | basic | special]

-ownerOf: "forsale"

4."holderAuth" NFT Saerch&#x20;

-nftType: \[game | basic | special]

-ownerOf: ""

-holderAuthYn: "Y"

#### Path Parameters

| Name                                  | Type | Description |
| ------------------------------------- | ---- | ----------- |
| wid<mark style="color:red;">\*</mark> | Int  | wallet id   |

#### Query Parameters

| Name         | Type   | Description                                           |
| ------------ | ------ | ----------------------------------------------------- |
| ntfType      | String | game \| basic \| spectial (empty for full search)     |
| ownerOf      | String | instock \| forsale \| soldout (empty for full search) |
| holderAuthYn | String | Y \| N (empty for full search)                        |
| pageNo       | Int    | default: 1                                            |
| pageSize     | Int    | default: 20                                           |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "paging": {
            "pageNo": 1,
            "pageSize": 20,
            "totalCount": 10,
            "hasMore": false
        },
        "items": [
            {
                "wid": 10003,
                "nftId": 10326,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 1,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10326,
                    "chainId": 3,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x0000000000000000000000000000000000000001",
                    "tokenId": "100000002",
                    "nftNm": "temporary_db_nft",
                    "nftSymbol": "temp",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": null,
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": null,
                    "nftDirectLink": null,
                    "holderAuthYn": "Y",
                    "nftHolderAuthDirectLink": null,
                    "marketId": null,
                    "gameCode": null,
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "N",
                    "btnNftcancelYn": "N",
                    "btnNftmodifyYn": "N",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10316,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 2,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10316,
                    "chainId": 3,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015002",
                    "nftType": "basic",
                    "contractAddress": "0xfd3f84d7635523d4b5c61c8d03f7c67944d25b26",
                    "tokenId": "2",
                    "nftNm": "irris jjang",
                    "nftSymbol": "IRRIS",
                    "nftSymbolImg": "https://dev-static.cube.store/markets/irris/images/2",
                    "nftMetaUri": "https://marble-api-dev.itamgames.com/tankers/markets/irris/nfts/2/metadata",
                    "nftMediaUri": null,
                    "nftAnimationUrl": "https://dev-static.cube.store/files/nft_farm/irris/video/irris_bottom.mp4",
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": null,
                    "nftDirectLink": null,
                    "holderAuthYn": "Y",
                    "nftHolderAuthDirectLink": "https://v2-xplatform-dev.itamgames.com/deeplink/nfts-holder-verification?productId=irris-tt-card",
                    "marketId": null,
                    "gameCode": null,
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "N",
                    "btnNftcancelYn": "N",
                    "btnNftmodifyYn": "N",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10243,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 4,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10243,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "257",
                    "nftNm": "GBNFT-NFT-257",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/257?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/257?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "Y",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10236,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 5,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10236,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "250",
                    "nftNm": "GBNFT-NFT-250",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/250?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/250?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "Y",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10228,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 6,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10228,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "242",
                    "nftNm": "GBNFT-NFT-242",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/242?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/242?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "Y",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10191,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 7,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10191,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "205",
                    "nftNm": "GBNFT-NFT-205",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/205?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/205?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10184,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 8,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10184,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "198",
                    "nftNm": "GBNFT-NFT-198",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/198?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/198?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10177,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 9,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10177,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "185",
                    "nftNm": "GBNFT-NFT-185",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/185?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/185?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10165,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 10,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10165,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "169",
                    "nftNm": "GBNFT-NFT-169",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/169?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/169?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            },
            {
                "wid": 10003,
                "nftId": 10164,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftOrd": 11,
                "displayYn": "Y",
                "nftInfo": {
                    "nftId": 10164,
                    "chainId": 1,
                    "assetTypeDcd": "1004003",
                    "assetType": "ERC721",
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x3544c960ee3f0e60fed444f3c3b6abe6236daa1a",
                    "tokenId": "168",
                    "nftNm": "GBNFT-NFT-168",
                    "nftSymbol": "GBNFT",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri": "https://api.itamgames.com/development/tankers/markets/golden-bros/nfts/168?publicationSource=game",
                    "nftMediaUri": null,
                    "nftAnimationUrl": null,
                    "nftMetaJson": null,
                    "nftDesc": null,
                    "nftSource": "game",
                    "nftDirectLink": "https://launcher-dev.itamgames.com/nft/golden-bros/168?source=game",
                    "holderAuthYn": "N",
                    "nftHolderAuthDirectLink": null,
                    "marketId": "golden-bros",
                    "gameCode": "gold",
                    "btnSendtogameYn": "N",
                    "btnNftsellYn": "Y",
                    "btnNftcancelYn": "Y",
                    "btnNftmodifyYn": "Y",
                    "binanceSaleYn": "N"
                }
            }
        ]
    }
}
            
```

{% endtab %}
{% endtabs %}

## Search - NFT detail&#x20;

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/nfts/{nftId}`

[List of NFTs Supported](#list-of-nfts-supported)

[NFTs Type](#nfts-type)

#### Path Parameters

| Name                                    | Type   | Description                         |
| --------------------------------------- | ------ | ----------------------------------- |
| wid<mark style="color:red;">\*</mark>   | Int    | wallet id                           |
| nftid<mark style="color:red;">\*</mark> | String | NFT id managed by the wallet server |

{% tabs %}
{% tab title="200: OK In response, nftMetaInfo is nullable, Internal property values ​​can be changed for each NFT." %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "items": [
            {
                "nftId": 10015,
                "ownerOfDcd": "1005001",
                "ownerOf": "in stock",
                "lockedYn": "N",
                "nftInfo": {
                    "chainId": 1,
                    "nftTypeDcd": "1015001",
                    "nftType": "game",
                    "contractAddress": "0x1fa7610837332da881db07e2cee7a0edc2da64d8",
                    "tokenId": "16452",
                    "nftNm": "ITAM-NFT-16452",
                    "nftSymbol": "ITAM",
                    "nftSymbolImg": "https://d39rr95p1k6fjx.cloudfront.net/resource/assets/image/symbol/DEFAULT_NFT.png",
                    "nftMetaUri":"https://api.itam.network/testnet/tankers/markets/itam/nfts/
```

{% endtab %}
{% endtabs %}

## Search - List of questions for restoration

<mark style="color:blue;">`GET`</mark> `https://apis.cubeapi.io/v1/questions`

#### Path Parameters

| Name                                  | Type | Description           |
| ------------------------------------- | ---- | --------------------- |
| fid<mark style="color:red;">\*</mark> | Int  | metaverse flatform id |

#### Query Parameters

| Name     | Type | Description |
| -------- | ---- | ----------- |
| pageNo   | Int  | default: 1  |
| pageSize | Int  | default: 20 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "paging": {
            "pageNo": 1,
            "pageSize": 20,
            "totalCount": 3,
            "hasMore": false
        },
        "items": [
            {
                "questionSeq": 5,
                "questionKr": "영화관에서 처음으로 관람한 영화를 입력해주세요.",
                "questionEn": "The first movie you saw at the cinema.",
                "questionJp": "映画館で初めて観た映画のタイトルを入力してください。"
            },
            {
                "questionSeq": 25,
                "questionKr": "처음 방문했던 해변의 이름을 입력해주세요.",
                "questionEn": "The name of the first beach you visited.",
                "questionJp": "初めて訪問した海辺の名前を入力してください。"
            },
            {
                "questionSeq": 28,
                "questionKr": "가장 좋아하는 스포츠 팀을 입력해주세요.",
                "questionEn": "Your favorite sports team.",
                "questionJp": "一番好きなスポーツチームを入力してください。"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## <mark style="color:green;">**POST**</mark>

~~*---------------------------------------------------------------------------------------------------*~~

## Create - FNCY HD Wallet(Internal)&#x20;

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets`

#### Request Body

| Name                                                     | Type   | Description                                                            |
| -------------------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| chainId<mark style="color:red;">\*</mark>                | Int    | Chain id managed by wallet server                                      |
| WalletNm<mark style="color:red;">\*</mark>               | String | Alias of wallet                                                        |
| rsaEncryptUserQuestion<mark style="color:red;">\*</mark> | String | Encrypted value with rsa public key after sha256 hash of user question |
| rsaEncryptUserAnswer<mark style="color:red;">\*</mark>   | String | Encrypted value with rsa public key after sha256 hash of user answer   |
| rsaEncryptUserPin<mark style="color:red;">\*</mark>      | String | Encrypted value with rsa public key after sha256 hash of password      |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "resultType": "WalletInsertResultCodes",
        "result": {
            "isSuccess": true|false,
            "code": "enum code of WalletInsertResultCodes",
            "number": http status code,
            "message": "http status message: result message"
        },
        "wid": 0
    }
}
```

{% endtab %}
{% endtabs %}

## Create - External Wallet

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets/external`

#### Request Body

| Name                                                           | Type   | Description                                                            |
| -------------------------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| chainId<mark style="color:red;">\*</mark>                      | Int    | Chain id managed by wallet server                                      |
| WalletNm<mark style="color:red;">\*</mark>                     | String | Alias of wallet                                                        |
| rsaEncryptUserQuestion<mark style="color:red;">\*</mark>       | String | Encrypted value with rsa public key after sha256 hash of user question |
| rsaEncryptUserAnswer<mark style="color:red;">\*</mark>         | String | Encrypted value with rsa public key after sha256 hash of user answer   |
| rsaEncryptUserPin<mark style="color:red;">\*</mark>            | String | Encrypted value with rsa public key after sha256 hash of password      |
| rsaEncryptExternalPrivateKey<mark style="color:red;">\*</mark> | String | Encrypted value of private key with rsa public key                     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "resultType": "WalletInsertResultCodes",
        "result": {
            "isSuccess": true|false,
            "code": "enum code of WalletInsertResultCodes",
            "number": http status code,
            "message": "http status message: result message"
        },
        "wid": 0
    }
}
```

{% endtab %}
{% endtabs %}

## Check - Wallet password

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets/pin-check`

**Encryption process**&#x20;

String text = "12345";

byte\[] hashKey = text.getBytes();

hashKey = Hash.sha256(hashKey)

hashKey = Hash.sha256(hashKey)

hashKey -> rsa publick key

#### Request Body

| Name                                                    | Type   | Description                                                                              |
| ------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------- |
| rsaEncryptedHashedPin<mark style="color:red;">\*</mark> | String | Encypted value of password with sha256 hash twice and Encypted with member\`s public key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "resultType": "WalletAuthenticationCheckResultCodes",
        "result": {
            "isSuccess": true|false,
            "code": "enum code of WalletAuthenticationCheckResultCodes",
            "number": http status code,
            "message": "http status message: result message"
        },
        "wid": 0
    }
}
```

{% endtab %}
{% endtabs %}

## Check - Question Answer

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets/answer-check`

**Encryption process**

String text = "12345";

byte\[] hashKey = text.getBytes();

hashKey = Hash.sha256(hashKey)

hashKey = Hash.sha256(hashKey)

hashKey -> rsa public key

#### Request Body

| Name                                                            | Type   | Description                                                                                       |
| --------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------- |
| rsaEncryptedHashedAnswer<mark style="color:red;">\*</mark>      | String | Encypted value of answer(lowercase) with sha256 hash twice and Encypted with member\`s public key |
| rsaEncryptedHashedAnswerAlter<mark style="color:red;">\*</mark> | String | Encypted value of answer(as it is) with sha256 hash twice and Encypted with member\`s public key  |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "resultType": "WalletAuthenticationCheckResultCodes",
        "result": {
            "isSuccess": true|false,
            "code": "enum code of WalletAuthenticationCheckResultCodes",
            "number": http status code,
            "message": "http status message: result message"
        },
        "wid": 0
    }
}
```

{% endtab %}
{% endtabs %}

## Check - Duplicate External Wallet(validity check)

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets/external-check`

#### Request Body

| Name                                                           | Type   | Description                                       |
| -------------------------------------------------------------- | ------ | ------------------------------------------------- |
| rsaEncryptExternalPrivateKey<mark style="color:red;">\*</mark> | String | Encryped value of private key with rsa public key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "resultType": "WalletInsertResultCodes",
        "result": {
            "isSuccess": true|false,
            "code": "enum code of WalletInsertResultCodes",
            "number": http status code,
            "message": "http status message: result message"
        },
        "wid": 0
    }
}
```

{% endtab %}
{% endtabs %}

## Search - Wallet connect signature&#x20;

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/signature`

#### Path Parameters

| Name                                  | Type | Description                      |
| ------------------------------------- | ---- | -------------------------------- |
| wid<mark style="color:red;">\*</mark> | Int  | wallet number you want to search |

#### Headers

| Name                                                    | Type   | Description                                                                        |
| ------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------- |
| dataToSign<mark style="color:red;">\*</mark>            | String | Value you want to sign                                                             |
| rsaEncryptedHashedPin<mark style="color:red;">\*</mark> | String | Encypted value of password with sha256 hash and Encypted with member\`s public key |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "apiVersion": "1",
  "status": {
    "code": 200,
    "message": "OK"
  },
  "data": {
    "signature": "signature value"
  }
}
```

{% endtab %}
{% endtabs %}

## Search - Wallet private key

<mark style="color:green;">`POST`</mark> `https://apis.cubeapi.io/v1/wallets/{wid}/private-key`

#### Request Body

| Name                                                    | Type   | Description                                                       |
| ------------------------------------------------------- | ------ | ----------------------------------------------------------------- |
| oneTimeRsaPubKey<mark style="color:red;">\*</mark>      | String | rsa public key generated by the client                            |
| rsaEncryptedHashedPin<mark style="color:red;">\*</mark> | String | Encypted value of password with sha256 hash and Encypted with rsa |

{% tabs %}
{% tab title="200: OK rsaEncryptedPrivateKey is not null, Decoding is required because it is encoded as base64, You can obtain a private key by decrypting it with ras private key generated in pairs with onTimeRsaPubKey" %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "items": [
            {
                "rsaEncryptedPrivateKey": "PrivateKey"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## ◾ <mark style="color:orange;">PATCH</mark>

~~*---------------------------------------------------------------------------------------------------*~~

## Restore -  User selected questions for restoration

<mark style="color:purple;">`PATCH`</mark> `https://apis.cubeapi.io/v1/wallets/restore/answer`

#### Request Body

| Name                                                        | Type   | Description                                                                                                                            |
| ----------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| rsaEncryptUserAnswer<mark style="color:red;">\*</mark>      | String | Encrypt the value obtained by hashing the user's question answer (lowercase processing) with sha256 2 with the member's rsa public key |
| rsaEncryptChangeUserPin<mark style="color:red;">\*</mark>   | String | Encrypt the new password sha256 hash with the member's rsa public key                                                                  |
| rsaEncryptUserAnswerAlter<mark style="color:red;">\*</mark> | String | Encrypting the user's question answer (as input) with sha256 hashed value 2 with the member's rsa public key                           |

## Change - Wallet password

<mark style="color:purple;">`PATCH`</mark> `https://devx-apis.cubeapi.io/v1/wallets/pin`

#### Request Body

| Name                                                      | Type   | Description                                                                     |
| --------------------------------------------------------- | ------ | ------------------------------------------------------------------------------- |
| rsaEncryptUserPin<mark style="color:red;">\*</mark>       | String | Encrypted value with rsa public key after sha256 hash of original password      |
| rsaEncryptChangeUserPin<mark style="color:red;">\*</mark> | String | Encrypted value with rsa public key after sha256 hash of password to be changed |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "apiVersion": "1",
    "status": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "resultType": "WalletPinChangeResultCodes",
        "result": {
            "isSuccess": true|false,
            "code": "enum code of WalletPinChangeResultCodes",
            "number": http status code,
            "message": "http status message: result message"
        },
        "wid": 0
    }
}
```

{% endtab %}
{% endtabs %}