NAV
go php js java

其他

币种查询

请求示例:

POST <base_path>/v2/coin/list HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"coin":"eth","chain":"eth","page":1,"page_size":20}

resp, err := client.Post("/v2/coin/list", map[string]any{
    "coin":      "eth",
    "chain":     "eth",
    "page":      1,
    "page_size": 20,
})
$resp = $client->post('/v2/coin/list', [
    'coin' => 'eth',
    'chain' => 'eth',
    'page' => 1,
    'page_size' => 20,
]);
const resp = await client.post('/v2/coin/list', {
  coin: 'eth',
  chain: 'eth',
  page: 1,
  page_size: 20,
});
String resp = client.post("/v2/coin/list", Map.of(
        "coin", "eth",
        "chain", "eth",
        "page", 1,
        "page_size", 20));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{ "status": 200, "msg": "处理成功", "data": { "page": 1, "max_page": 2, "count": 20, "list": [ { "coin": "eth", "chain": "eth", "contract_address": "", "status": "1", "open_in": 1, "open_out": 1, "open_address": "1", "confirm_count": "6", "min_transfer_in_amount": "0.00000001", "min_transfer_out_amount": "0" }, { "coin": "hc", "chain": "hc", "contract_address": "", "status": "1", "open_in": 1, "open_out": 1, "open_address": "1", "confirm_count": "1", "min_transfer_in_amount": "0", "min_transfer_out_amount": "0.0001" }, …… ] }, "date_time": "2020-08-04 15:19:56", "time_stamp": 1596525596 }

商家支持币种查询接口

HTTP Request

POST /v2/coin/list

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
coin 否 string 币名(如:eth)
chain 否 string 主链名(查询 主链及其代币,如:eth)
page 否 integer,默认值为1 1<= N <=Max, N>Max ? N=Max ; N<1 ? N=1
page_size 否 integer 每页数量 (20 ~500),默认 20

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object 具体见下面 “data细节说明”。
data.page integer 第几页
data.max_page integer 总页数
data.count integer 当前页记录数
data.list array 具体每条记录
data.list.coin string 币种
data.list.chain string 主链名
data.list.status integer 状态:1 开启;0 关闭
data.list.open_in integer 充值状态:1 开启;0 关闭
data.list.open_out integer 提现状态:1 开启;0 关闭
data.list.open_address integer 分配地址状态::1 开启;0 关闭
data.list.confirm_count integer 充值确认数(默认 6 实际入账以订单状态为准)
data.list.min_transfer_in_amount string 最小转入金额(0 表示不限制 )
data.list.min_transfer_out_amount string 最小提现金额(0 表示不限制 )
data.list.contract_address string 合约币种的合约地址
date_time string 响应时间
time_stamp integer 无时区的秒

币价汇率

请求示例:

POST <base_path>/v2/rate/index HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"source_coin":"eth","target_coin":"usdt"}
resp, err := client.Post("/v2/rate/index", map[string]any{
    "source_coin": "eth",
    "target_coin": "usdt",
})
$resp = $client->post('/v2/rate/index', [
    'source_coin' => 'eth',
    'target_coin' => 'usdt',
]);
const resp = await client.post('/v2/rate/index', {
  source_coin: 'eth',
  target_coin: 'usdt',
});
String resp = client.post("/v2/rate/index", Map.of("source_coin", "eth", "target_coin", "usdt"));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status":200,
  "msg":"请求成功",
  "data":{
    "rate":"19490.64944834 "
  },
  "date_time":"2020-01-14 00:50:27"
}

各种币对应usdt 的汇率(用于币价计算,不用于兑换,兑换请走兑换汇率接口)。目前支持(btc eth hc eos trx xrp)

HTTP Request

POST /v2/rate/index

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
source_coin 是 string 兑换币
target_coin 是 string 目标币 目前只支持 usdt

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object 具体见下面 “data细节说明”。
data.rate string 汇率 如 1btc= 19490.64944834 usdt
date_time string 响应时间
time_stamp integer 无时区的秒

币种对法币价格汇率

请求示例:

POST <base_path>/v2/rate/fiatCurrency HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"source_coin":"eth","target_currency":"usd"}
resp, err := client.Post("/v2/rate/fiatCurrency", map[string]any{
    "source_coin":     "eth",
    "target_currency": "usd",
})
$resp = $client->post('/v2/rate/fiatCurrency', [
    'source_coin' => 'eth',
    'target_currency' => 'usd',
]);
const resp = await client.post('/v2/rate/fiatCurrency', {
  source_coin: 'eth',
  target_currency: 'usd',
});
String resp = client.post("/v2/rate/fiatCurrency", Map.of("source_coin", "eth", "target_currency", "usd"));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status":200,
  "msg":"请求成功",
  "data":{
    "rate":"2166.81",
    "source_coin": "eth",
    "target_currency": "usd"
  },
  "date_time":"2020-01-14 00:50:27"
}

HTTP Request

POST /v2/rate/fiatCurrency

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
source_coin 是 string 待换算数字货币币名
target_currency 是 string 目标法币,默认usd。支持usd,cny,aed,sgd,jpy,krw等。

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object 具体见下面 “data细节说明”。
data.rate string 汇率价格 如 1eth= 2166.81 usd
data.source_coin string 待换算数字货币币名
data.target_currency string 目标法币
date_time string 响应时间
time_stamp integer 无时区的秒

归集手续费计算

请求示例:

POST <base_path>/v2/balance/transactionFee HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"coin":"eth"}
resp, err := client.Post("/v2/balance/transactionFee", map[string]any{
    "coin": "eth",
})
$resp = $client->post('/v2/balance/transactionFee', [
    'coin' => 'eth',
]);
const resp = await client.post('/v2/balance/transactionFee', {
  coin: 'eth',
});
String resp = client.post("/v2/balance/transactionFee", Map.of("coin", "eth"));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status":200,
  "msg":"请求成功",
  "data":{
    "fee":"0.01386",
    "coin":"eth"
  },
  "date_time":"2020-10-20 15:58:53",
  "time_stamp":1603180733
}

HTTP Request

POST /v2/balance/transactionFee

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
coin 是 string 币名 由平台提供为准

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object
data.fee string 手续费
data.coin string 币名(手续费单位)
date_time string 响应时间
time_stamp integer 无时区的秒

提现gas费预估查询

请求示例:

POST <base_path>/v2/transfer/transactionFee HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"coin":"eth"}
resp, err := client.Post("/v2/transfer/transactionFee", map[string]any{
    "coin": "eth",
})
$resp = $client->post('/v2/transfer/transactionFee', [
    'coin' => 'eth',
]);
const resp = await client.post('/v2/transfer/transactionFee', {
  coin: 'eth',
});
String resp = client.post("/v2/transfer/transactionFee", Map.of("coin", "eth"));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status": 200,
  "msg": "请求成功",
  "data": [
    {
      "coin": "fil", //币名
      "fee": "0.00379379", //当前币(coin) 交易手续费
      "unit": "fil"//手续费单位
    }, {
      "coin": "eth",
      "fee": "0.000231",
      "unit": "eth"
    }, {
      "coin": "mof",
      "fee": "0.00000005",
      "unit": "eth"
    }
  ],
  "date_time": "2021-06-17 16:58:52",
  "time_stamp": 1623920332
}

提现手续费预估查询接口,返回支持币种提现的手续费。(目前只支持eth及其合约、fil)

HTTP Request

POST /v2/transfer/transactionFee

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
coin 否 string 币名 由平台提供为准

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object trade_id-由商户提供
data.coin string 币名
data.fee string 手续费
data.unit string 手续费单位
date_time string 响应时间
time_stamp integer 无时区的秒

退款记录列表

请求示例:

POST <base_path>/v2/refund/list HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"page":1}
resp, err := client.Post("/v2/refund/list", map[string]any{
    "page": 1,
})
$resp = $client->post('/v2/refund/list', [
    'page' => 1,
]);
const resp = await client.post('/v2/refund/list', {
  page: 1,
});
String resp = client.post("/v2/refund/list", Map.of("page", 1));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status": 200,
  "msg": "处理成功",
  "data": {
    "page": 1,
    "max_page": 1,
    "count": 1,
    "list": [{
      "block_number": 69471385,
      "block_time": 1742882698,
      "coin": "pol",
      "contract": "pol",
      "contract_address": "",
      "created_at": 1742882633,
      "creator": "CS007",
      "end_time": 1742882749,
      "from_address": "0xDCE6e20FfC7b651Cd5d7ad922b8B77691E999dB2",
      "gas_fee": "0.00062635",
      "method": 0,
      "order_id": "20250101123456",
      "receive_amount": "0.03",
      "receive_order_id": "",
      "receive_txid": "0xb6042b5eac8a9b7fbc538ad9564b2ada7d59cbc39a462d2da784494562556590",
      "refund_amount": "0.029",
      "remark": "",
      "status": 1,
      "to_address": "0xb4bd96957e7b078566cd1e40de2c131d1f4374e4",
      "txid": "0xc3b148c2ede826bbadf68682486fce8fabe5a5c53e3973c45b9e5578787ff359",
      "type": 1
    }]
  },
  "date_time": "2022-07-22 18:36:36",
  "time_stamp": 1658486196
}

HTTP Request

POST /v2/refund/list

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
page 否 integer 1<= N <=Max,对于超过Max的取Max,小于1或没有传参数的返回1
page_size 否 integer 每页数量 (20 ~100),默认 20
sort_num 否 integer 列表排序规则 默认按入系统时间正序排列( 1 正序 ; 2 倒序)
status 否 string 状态,默认不传返回所有状态。0 等待退款; 1 退款成功; 2 退款失败; 5 待商户审核; 6 审核不通过; 10 待平台审核; 11 平台审核不通过; 25 退款中; 26 退款Gas费不足等待中;
start_time 否 integer 开始时间(创建时间) 格式 :时间戳
end_time 否 integer 结束时间(创建时间) 格式 :时间戳
contract 否 string 网络主币名
coin 否 string 币名
receive_order_id 否 string 关联的充值订单号
receive_txid 否 string 关联充值记录的链上交易hash
txid 否 string 该退款交易的链上交易hash
from_address 否 string 退款来源地址,即充值交易的收款用户地址
to_address 否 string 退款目标地址(冷地址或充值的来源地址)

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object trade_id-由商户提供
data.page integer 第几页
data.count integer 本页记录数
data.list array 具体每条记录
data.list.block_number integer 退款交易区块高度
data.list.block_time integer 退款交易上链时间
data.list.coin string 币种
data.list.contract string 主链
data.list.contract_address string 币种合约地址
data.list.created_at integer 退款创建时间
data.list.creator string 退款发起商家管理员
data.list.end_time integer 退款结束时间
data.list.from_address string 退款来源地址,即充值交易的收款用户地址
data.list.gas_fee string 退款交易链上手续费
data.list.method integer 退款方式,0原路返回,1冷钱包
data.list.order_id string 退款订单号
data.list.receive_amount string 被退款的充值交易金额
data.list.receive_order_id string 关联的充值订单号
data.list.receive_txid string 关联充值记录的链上交易hash
data.list.refund_amount string 实际退款金额
data.list.remark string 备注
data.list.status integer 状态,0 等待退款; 1 退款成功; 2 退款失败; 5 待商户审核; 6 审核不通过; 10 待平台审核; 11 平台审核不通过; 25 退款中; 26 退款Gas费不足等待中;
data.list.to_address string 退款目标地址(冷地址或充值的来源地址)
data.list.txid string 退款交易的链上交易hash
data.list.type integer 类型,0关联充值单 1无充值单且平台支持币种 2无充值单且平台不支持币种 3无充值单且平台不支持的主链
date_time string 响应时间
time_stamp integer 无时区的秒

检测其账本记录的币种数量是否和其链上钱包的数据一致

请求示例:

POST <base_path>/v2/reconcile/balances HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"list":[{"chain":"eth","coin":"usdt_erc20","ledger_balance":"100"},{"chain":"btc","coin":"btc","ledger_balance":"10"}]}
resp, err := client.Post("/v2/reconcile/balances", map[string]any{
    "list": []map[string]any{
        {"chain": "eth", "coin": "usdt_erc20", "ledger_balance": "100"},
        {"chain": "btc", "coin": "btc", "ledger_balance": "10"},
    },
})
$resp = $client->post('/v2/reconcile/balances', [
    'list' => [
        ['chain' => 'eth', 'coin' => 'usdt_erc20', 'ledger_balance' => '100'],
        ['chain' => 'btc', 'coin' => 'btc', 'ledger_balance' => '10'],
    ],
]);
const resp = await client.post('/v2/reconcile/balances', {
  list: [
    { chain: 'eth', coin: 'usdt_erc20', ledger_balance: '100' },
    { chain: 'btc', coin: 'btc', ledger_balance: '10' },
  ],
});
String resp = client.post("/v2/reconcile/balances", Map.of(
        "list", List.of(
                Map.of("chain", "eth", "coin", "usdt_erc20", "ledger_balance", "100"),
                Map.of("chain", "btc", "coin", "btc", "ledger_balance", "10"))));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status": 200,
  "msg": "处理成功",
  "data": {
    "list": [
      {
        "chain": "eth",
        "coin": "usdt_erc20",
        "ledger_balance": "100",
        "onchain_balance": "100",
        "matched": true,
        "note": "",
        "difference": "0"
      },
      {
        "chain": "btc",
        "coin": "btc",
        "ledger_balance": "10",
        "onchain_balance": "9",
        "matched": false,
        "note": "",
        "difference": "-1"
      }
    ]
  },
  "date_time": "2022-07-22 18:36:36",
  "time_stamp": 1658486196
}

HTTP Request

POST /v2/reconcile/balances

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
list.chain 否 string 主链
list.coin 是 string 币种
list.ledger_balance 否 string 账本余额

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object data
data.list array 具体每条记录
data.list.chain string 主链
data.list.coin string 币种
data.list.ledger_balance string 账本余额
data.list.onchain_balance string 账本余额
data.list.difference string 余额差值
data.list.matched boolean 余额是否匹配
data.list.note string 说明描述
date_time string 响应时间
time_stamp integer 无时区的秒

检测其某个账户地址的币种数量是否其链上数量一致

请求示例:

POST <base_path>/v2/reconcile/addressBalance HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"list":[{"chain":"eth","coin":"usdt_erc20","address":"0x111...2222","ledger_balance":"100"},{"chain":"btc","coin":"btc","address":"1bcd...zxc","ledger_balance":"10"}]}
resp, err := client.Post("/v2/reconcile/addressBalance", map[string]any{
    "list": []map[string]any{
        {"chain": "eth", "coin": "usdt_erc20", "address": "0x111...2222", "ledger_balance": "100"},
        {"chain": "btc", "coin": "btc", "address": "1bcd...zxc", "ledger_balance": "10"},
    },
})
$resp = $client->post('/v2/reconcile/addressBalance', [
    'list' => [
        ['chain' => 'eth', 'coin' => 'usdt_erc20', 'address' => '0x111...2222', 'ledger_balance' => '100'],
        ['chain' => 'btc', 'coin' => 'btc', 'address' => '1bcd...zxc', 'ledger_balance' => '10'],
    ],
]);
const resp = await client.post('/v2/reconcile/addressBalance', {
  list: [
    { chain: 'eth', coin: 'usdt_erc20', address: '0x111...2222', ledger_balance: '100' },
    { chain: 'btc', coin: 'btc', address: '1bcd...zxc', ledger_balance: '10' },
  ],
});
String resp = client.post("/v2/reconcile/addressBalance", Map.of(
        "list", List.of(
                Map.of("chain", "eth", "coin", "usdt_erc20", "address", "0x111...2222", "ledger_balance", "100"),
                Map.of("chain", "btc", "coin", "btc", "address", "1bcd...zxc", "ledger_balance", "10"))));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status": 200,
  "msg": "处理成功",
  "data": {
    "list": [
      {
        "chain": "eth",
        "coin": "usdt_erc20",
        "address": "0x111...2222",
        "matched": true,
        "ledger_amount": "100",
        "onchain_balance": "100",
        "note": "",
        "difference": "0"
      },
      {
        "chain": "btc",
        "coin": "btc",
        "address": "1bcd...zxc",
        "matched": false,
        "ledger_amount": "10",
        "onchain_balance": "9",
        "note": "",
        "difference": "-1"
      }
    ]
  },
  "date_time": "2022-07-22 18:36:36",
  "time_stamp": 1658486196
}

HTTP Request

POST /v2/reconcile/addressBalance

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
list.chain 否 string 主链
list.coin 是 string 币种
list.address 是 string 链上账户地址
list.ledger_balance 否 string 账本余额

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object data
data.list array 具体每条记录
data.list.chain string 主链
data.list.coin string 币种
data.list.address string 链上账户地址
data.list.ledger_balance string 账本余额
data.list.onchain_balance string 账本余额
data.list.difference string 余额差值
data.list.matched boolean 余额是否匹配
data.list.note boolean 说明描述
date_time string 响应时间
time_stamp integer 无时区的秒

检测内部账本记录的提币数据是否和其钱包链上的数据一致

请求示例:

POST <base_path>/v2/reconcile/withdrawal HTTP/1.1
Host: api.xxxx.com
Content-Type: application/json
X-Cbc-App-Id: hxgmau9imt86qky9
X-Cbc-Key-Version: admin
X-Cbc-Timestamp: 1792382460
X-Cbc-Nonce: 7c1e9a3b5d7f9b1d3f5a7c9e1b3d5f7a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{"list":[{"trade_id":"W20250001","chain":"eth","coin":"usdt_erc20","from_address":"0x111...222","to_address":"0x111...333","txid":"0x123...321","ledger_amount":"100"},{"trade_id":"W20250002","chain":"btc","coin":"btc","from_address":"bc1q...3cyx","to_address":"bc1q...0cur","txid":"dd8a...7ff8","ledger_amount":"100"}]}
resp, err := client.Post("/v2/reconcile/withdrawal", map[string]any{
    "list": []map[string]any{
        {"trade_id": "W20250001", "chain": "eth", "coin": "usdt_erc20", "from_address": "0x111...222", "to_address": "0x111...333", "txid": "0x123...321", "ledger_amount": "100"},
        {"trade_id": "W20250002", "chain": "btc", "coin": "btc", "from_address": "bc1q...3cyx", "to_address": "bc1q...0cur", "txid": "dd8a...7ff8", "ledger_amount": "100"},
    },
})
$resp = $client->post('/v2/reconcile/withdrawal', [
    'list' => [
        ['trade_id' => 'W20250001', 'chain' => 'eth', 'coin' => 'usdt_erc20', 'from_address' => '0x111...222', 'to_address' => '0x111...333', 'txid' => '0x123...321', 'ledger_amount' => '100'],
        ['trade_id' => 'W20250002', 'chain' => 'btc', 'coin' => 'btc', 'from_address' => 'bc1q...3cyx', 'to_address' => 'bc1q...0cur', 'txid' => 'dd8a...7ff8', 'ledger_amount' => '100'],
    ],
]);
const resp = await client.post('/v2/reconcile/withdrawal', {
  list: [
    { trade_id: 'W20250001', chain: 'eth', coin: 'usdt_erc20', from_address: '0x111...222', to_address: '0x111...333', txid: '0x123...321', ledger_amount: '100' },
    { trade_id: 'W20250002', chain: 'btc', coin: 'btc', from_address: 'bc1q...3cyx', to_address: 'bc1q...0cur', txid: 'dd8a...7ff8', ledger_amount: '100' },
  ],
});
String resp = client.post("/v2/reconcile/withdrawal", Map.of(
        "list", List.of(
                Map.of("trade_id", "W20250001", "chain", "eth", "coin", "usdt_erc20", "from_address", "0x111...222", "to_address", "0x111...333", "txid", "0x123...321", "ledger_amount", "100"),
                Map.of("trade_id", "W20250002", "chain", "btc", "coin", "btc", "from_address", "bc1q...3cyx", "to_address", "bc1q...0cur", "txid", "dd8a...7ff8", "ledger_amount", "100"))));

返回结果示例:

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Request-ID: 4bf92f3577b34da6a3ce929d0e0e4736
X-Cbc-Timestamp: 1792382461
X-Cbc-Nonce: 3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a
X-Cbc-Sign-Alg: RSA-SHA256
X-Cbc-Signature: <base64>

{
  "status": 200,
  "msg": "处理成功",
  "data": {
    "list": [
      {
        "trade_id": "W20250001",
        "chain": "eth",
        "coin": "usdt_erc20",
        "from_address": "0x111...222",
        "to_address": "0x111...333",
        "txid": "0x123...321",
        "matched": true,
        "ledger_amount": "100.00",
        "onchain_amount": "100.00",
        "difference": "0",
        "note": ""
      },
      {
        "trade_id": "W20250002",
        "chain": "btc",
        "coin": "btc",
        "from_address": "bc1q...3cyx",
        "to_address": "bc1q...0cur",
        "txid": "dd8a...7ff8",
        "matched": false,
        "onchain_amount": "99.12",
        "ledger_amount": "100.00",
        "difference": "-0.88",
        "note": ""
      }
    ]
  },
  "date_time": "2022-07-22 18:36:36",
  "time_stamp": 1658486196
}

HTTP Request

POST /v2/reconcile/withdrawal

请求参数

公共 Header 见签名规则,下表只列 body 中的业务参数。

参数名 必选 类型 说明
list.trade_id 是 string 商户提现单号
list.chain 否 string 主链,只原样回显,不参与对账
list.coin 否 string 币种
list.ledger_amount 否 string 转账数量
list.from_address 否 string 提现单链上出款账户地址
list.to_address 否 string 提现单链上收款账户地址
list.txid 否 string 提现单链上交易hash

返回参数说明

参数名 类型 说明
status integer 状态码
msg string 状态描述
data object data
data.list array 具体每条记录
data.list.trade_id string 商户提现单号
data.list.chain string 主链
data.list.coin string 币种
data.list.from_address string 提现单链上出款账户地址
data.list.to_address string 提现单链上收款账户地址
data.list.ledger_amount string 账单记录转账数量
data.list.onchain_amount string 链上交易转账数量
data.list.difference string 数量差值
data.list.matched boolean 交易数量是否匹配
data.list.note string 说明描述
date_time string 响应时间
time_stamp integer 无时区的秒