콘텐츠로 이동

Wallet API

Wallet API는 지갑을 생성하고 지갑 정보와 잔고를 조회하는 기능을 제공합니다.

지갑 생성¶

공개키-개인키(또는 니모닉 문구) 쌍과 지갑 주소를 생성합니다.

Request URL¶

Live URL	https://bc-api.qpyou.cn/core/v0/wallet
Sandbox URL	https://sandbox-bc-api.qpyou.cn/core/v0/wallet
HTTP Method	POST
Content-Type	application/json

Header parameters¶

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses¶

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.address	생성된 지갑 주소	string
data.privateKey	생성된 지갑의 개인키	string
data.publicKey	생성된 지갑의 공개키 (xpla)	string

Request sample¶

curl -X 'POST' 
  'https://sandbox-bc-api.qpyou.cn/core/v0/wallet' 
  -H 'accept: */*' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'x-network: polygon' 
  -d ''

Response sample¶

// Polygon
{
  "code": 0,
  "message": "success",
  "data": {
    "address": "0x413a1bF6584fF29d663f6CE5cf3F1Fce2064cf4d",
    "privateKey": "0x250748507c8d83cc71fb4178d0b989062dc8e02ea050f9078ae0d8fbfda4d845"
  }
}
// Xpla
{
  "code": 0,
  "message": "success",
  "data": {
    "address": "xpla1xckvhyu48uqlhduqgd79y45tpfhqlnrqhr87nt",
    "publicKey": "AvNhefa+7fhS7RH/VryEtz1yWzXKGS1+jnheotpOMuSV",
    "privateKey": "pledge outdoor ginger assault key luxury appear roast immense march burden charge season sea raw suspect tenant fossil portion easily onion fragile castle spoil"
  }
}

지갑 정보 조회¶

Nonce(sequence), Account Number 등 계정 상태 정보를 조회합니다. 다중 서명 지갑일 경우, 다중 서명 지갑 계정에서 트랜잭션을 전송할 때 필요한 서명 정족수와 서명자들 정보를 조회합니다.

Request URL¶

Live URL	https://bc-api.qpyou.cn/core/v1/wallet/{address}
Sandbox URL	https://sandbox-bc-api.qpyou.cn/core/v1/wallet/{address}
HTTP Method	GET
Content-Type	application/json

Path parameters¶

필드명	설명	타입	필수 여부
address	조회할 계정 주소	string	Y

Header parameters¶

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses¶

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.nonce	조회하는 지갑의 논스(시퀀스)	number
data.accountNumber	조회하는 지갑의 계정 번호 (xpla)	number
data.publicKey	조회하는 지갑의 공개키 (xpla)	string
data.type	지갑 유형 SINGLE: 단일 서명 지갑 (일반 지갑) MULTI: 다중 서명 지갑	string
data.signers	지갑 유형이 MULTI일 때, 다수 서명자들의 지갑 주소들	array
data.threshold	다중 서명 정족수	number

Request sample¶

curl -X 'GET' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/wallet/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765' 
  -H 'accept: */*' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'x-network: polygon'

Response sample¶

// Polygon (SINGLE)
{
  "code": 0,
  "message": "success",
  "data": {
    "nonce": 185,
     "type": "SINGLE"
  }
}
// Xpla (SINGLE)
{
  "code": 0,
  "message": "success",
  "data": {
    "nonce": 52,
    "accountNumber": 4658,
    "publicKey": "xplapub1qtet7gjzyt6h3rm79ragfanses4xwgx6hjtjzh2juvtklxhup5gpgepz4yz",
     "type": "SINGLE"
  }
}
// Polygon (MULTI)
{
  "code": 0,
  "message": "success",
  "data": {
    "nonce": 185,
     "type": "MULTI",
     "signers": ["xpla1c49ehdl8dcd3wv0vj52h25gfxkxkr7sfpvqrhw", "xpla1gzq6a8t4dt9lpth6ufzlnnvll9cdsdfgmrhk73", "xpla16xhh685u829vrm407sq8rf82wt4gjudslzgtm7 "],
     "threshold": 2 
  }
}
// Xpla (MULTI)
{
  "code": 0,
  "message": "success",
  "data": {
    "nonce": 52,
    "accountNumber": 4658,
    "publicKey": "xplapub1qtet7gjzyt6h3rm79ragfanses4xwgx6hjtjzh2juvtklxhup5gpgepz4yz",
     "type": "MULTI",
     "signers": ["0xD6e69da7f1be111394dfef4C48eaC9b52ddf2Fd0", "0xA10078576Ca6f63dc6f78ff9a8ed8bd05B51f463", "0xa245824a24daf3b312d3f59c7debf162c4993e8b"],
     "threshold": 2 
   }
}

지갑 잔고 조회¶

계정이 보유한 블록체인의 기초 통화 잔고(Polygon:Matic, XPLA:xpla)를 조회합니다.

Request URL¶

Live URL	https://bc-api.qpyou.cn/core/v1/wallet/{address}/balance
Sandbox URL	https://sandbox-bc-api.qpyou.cn/core/v1/wallet/{address}/balance
HTTP Method	GET
Content-Type	application/json

Path parameters¶

필드명	설명	타입	필수 여부
address	조회할 계정 주소	string	Y

Header parameters¶

필드명	설명	타입	필수 여부
x-network	블록체인 네트워크{ploygon, xpla}	string	Y
Authorization	API를 호출하기 위한 인증 토큰	string	Y

Responses¶

필드명	설명	타입
code	api 호출 결과 코드, 0:성공	number
message	결과 메시지	string
data	API 응답 데이터	json
data.balance	계정이 보유한 잔고	string
data.rawBalance	계정이 보유한 `data.decimals`을 적용하지 않은 잔고	string
data.decimals	토큰 소수점 최대 자리수	number

Request sample¶

curl -X 'GET' 
  'https://sandbox-bc-api.qpyou.cn/core/v1/wallet/0x9428e6eF51FEb2201676deEc11B7E36F7c1F0765/balance' 
  -H 'accept: */*' 
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJp...' 
  -H 'x-network: polygon'

Response sample¶

{
  "code": 0,
  "message": "success",
  "data": {
    "balance": "0.198284931197886585",
    "rawBalance": "198284931197886585",
    "decimals": 18
  }
}