コンテンツにスキップ

ウォレットAPI

ウォレットAPIはウォレットを作成し、ウォレット情報とその残高を取得します。

ウォレットを作成する

公開鍵 - 秘密鍵のペア（またはニーモニックフレーズ）とウォレットアドレスを作成します。

リクエストURL

ライブURL https://bc-api.qpyou.cn/core/v0/wallet
サンドボックスURL https://sandbox-bc-api.qpyou.cn/core/v0/wallet
HTTPメソッド POST
コンテンツタイプ application/json

ヘッダー パラメータ

フィールド名 説明 タイプ 必須
x-network ブロックチェーンネットワーク 文字列 Y
Authorization APIを呼び出すために必要な認証トークン 文字列 Y

応答

フィールド名 説明 型
code APIリクエスト結果コード、0: 成功 数値
message 結果メッセージ 文字列
data APIレスポンスデータ JSON
data.address 作成されたウォレットアドレス 文字列
data.privateKey 作成されたウォレットの秘密鍵 文字列
data.publicKey 作成された鍵の公開鍵 (xpla) 文字列

リクエストサンプル

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（シーケンス）とアカウント番号を含むアカウントのステータスを取得します。ウォレットがa multi-sig walletの場合、APIはこのウォレットからトランザクションを送信するために必要なthresholdsと署名者に関する情報を返します。

リクエスト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 ブロックチェーンネットワーク 文字列 Y
Authorization APIを呼び出すために必要な認証トークン 文字列 Y

応答

フィールド名 説明 タイプ
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 ブロックチェーンネットワーク 文字列 Y
Authorization APIを呼び出すために必要な認証トークン 文字列 Y

応答

フィールド名 説明 タイプ
code APIリクエスト結果コード、0: 成功 数字
message 結果メッセージ 文字列
data APIレスポンスデータ JSON
data.balance アカウントが持っている残高 文字列
data.rawBalance data.decimalsを適用していないアカウントのウォレット残高 文字列
data.decimals トークンの最大小数点以下の桁数 数字

リクエストサンプル

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