钱包 API

钱包 API 创建一个钱包，并获取钱包信息及其余额。

创建钱包¶

创建一个公钥 - 私钥对（或助记词）和一个钱包地址。

请求 URL¶

直播网址	https://bc-api.qpyou.cn/core/v0/wallet
沙盒网址	https://sandbox-bc-api.qpyou.cn/core/v0/wallet
HTTP 方法	POST
内容类型	application/json

头部参数¶

字段名称	描述	类型	必需
x-network	区块链网络	字符串	是
Authorization	调用API所需的认证令牌	字符串	是

响应¶

字段名称	描述	类型
code	API请求结果代码，0：成功	number
message	结果消息	String
data	API响应数据	json
data.address	创建的钱包地址	string
data.privateKey	创建的钱包的私钥	string
data.publicKey	创建的密钥（xpla）的公钥	string

请求示例¶

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

响应示例¶

// 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（序列）、账户号码等。获取账户状态，包括 nonce（序列）和账户号码。如果钱包是多重签名钱包，则 API 返回从该钱包发送交易所需的阈值和有关签名者的信息。

请求 URL¶

直播 URL	https://bc-api.qpyou.cn/core/v1/wallet/{address}
沙盒 URL	https://sandbox-bc-api.qpyou.cn/core/v1/wallet/{address}
HTTP 方法	GET
内容类型	application/json

路径参数¶

字段名称	描述	类型	必需
address	将返回其信息的账户地址	字符串	Y

头部参数¶

字段名称	描述	类型	必需
x-network	区块链网络	字符串	是
Authorization	调用 API 所需的身份验证令牌	字符串	是

响应¶

字段名称	描述	类型
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

请求示例¶

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

响应示例¶

  // 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）。

请求 URL¶

实时 URL	https://bc-api.qpyou.cn/core/v1/wallet/{address}/balance
沙盒 URL	https://sandbox-bc-api.qpyou.cn/core/v1/wallet/{address}/balance
HTTP 方法	GET
内容类型	application/json

路径参数¶

字段名称	描述	类型	必需
address	将返回其信息的账户地址	字符串	Y

头部参数¶

字段名称	描述	类型	必需
x-network	区块链网络	字符串	是
Authorization	调用API所需的身份验证令牌	字符串	是

响应¶

字段名称	描述	类型
code	api 请求结果代码，0：成功	number
message	结果消息	String
data	API 响应数据	json
data.balance	账户拥有的余额	string
data.rawBalance	账户的钱包余额，不应用 `data.decimals`	string
data.decimals	代币的最大小数位数	number

请求示例¶

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'

响应示例¶

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