WepinBlogContact

토큰 및 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 와 동일 합니다.

Previous지갑 생성 및 관리Next트랜잭션

Last updated

Was this helpful?