토큰 및 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


계정 잔액 새로 고침

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

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


NFT 정보 조회 하기

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

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

  • 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 를 제공할 것을 권장합니다.

Request

Parameter

Name
Type
Description
Required

userId

String

로그인 과정에서 받은 userInfo 의 userId

O

walletId

String

로그인 결과 받은 사용자 지갑 ID

O

Response

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

Last updated

Was this helpful?