토큰 및 NFT 조회

계정 정보 조회 하기

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

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

Name	Type	Description	Required
userId	String	로그인 과정에서 받은 userInfo의 userId	O
walletId	String	로그인 결과 받은 사용자 지갑 ID	O

Response

Success Response

Name	Type	Description
walletId	String	사용자 지갑 ID
accounts	Account(Object) []	조회 된 계정 리스트 (Account)

• 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

// 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"
    }
  ]
}

---

계정 잔액 새로 고침

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

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

Name	Type	Description	Required
accountId	String	계정 정보 조회 시 받은 accountId	O

Response

Success Response

Name	Type	Description
balance	String	계정 잔액
decimals	Integer	계정의 데시멀 값
symbol	String	계정의 심볼
tokens	TokenBalance(Object) []	계정 토큰들의 잔액 리스트 (TokenBalance)

• TokenBalance

  • balance String

    • 토큰 계정 잔액

  • decimals Integer

    • 토큰 계정 데이멀 값

  • symbol String

    • 토큰 계정의 심볼

  • contract String

    • 토큰 계정의 컨트랙트 주소

Example

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

---

NFT 정보 조회 하기

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

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

Name	Type	Description	Required
userId	String	로그인 과정에서 받은 userInfo의 userId	O
walletId	String	로그인 결과 받은 사용자 지갑 ID	O

Response

Success Response

Name	Type	Description
nfts	NFT(Object) []	조회 된 NFT 리스트 (NFT)

• 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

  {
  	"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 정보 새로 고침

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

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

Name	Type	Description	Required
userId	String	로그인 과정에서 받은 userInfo 의 userId	O
walletId	String	로그인 결과 받은 사용자 지갑 ID	O

Response

NFT 정보 조회 하기 Response 와 동일 합니다.