其他
币种查询
请求示例:
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
}
- 功能: 充值订单归集手续费计算
- 目前仅支持 eth 、usdt_erc20 ,其他币种后续持续扩充。
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 | 无时区的秒 |