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 ''

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

// 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'

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 (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'

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
  }
}

{

"code": 0,

"message": "success",

"data": {

"balance": "0.198284931197886585",

"rawBalance": "198284931197886585",

"decimals": 18

}

지갑 생성

Request URL

Header Parameters

Responses

Request Sample

Response Sample

지갑 정보 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

지갑 잔고 조회

Request URL

Path Parameters

Header Parameters

Responses

Request Sample

Response Sample

시작하기

SDK 개발

콘솔 가이드

다운로드

API 문서

지원