Statistics
Merchant financial settlement ledger
Request example:
POST <base_path>/v2/balance/generalAccount 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>
{}
resp, err := client.Post("/v2/balance/generalAccount", nil)
$resp = $client->post('/v2/balance/generalAccount');
const resp = await client.post('/v2/balance/generalAccount');
String resp = client.post("/v2/balance/generalAccount", Map.of());
Example of return result:
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":"Request successful",
"data":[
{
"coin" :"eth",
"receive_amount":"2.202508",
"send_amount":0,
"hot_address_amount":"28.49831843",
"settlement_amount":"2.15252525",
"wait_settlement_amount":"0.04998275"
},
{
"coin" :"trx",
"receive_amount":0,
"send_amount":0,
"hot_address_amount":0,
"settlement_amount":0,
"wait_settlement_amount":0
},
"usdt_erc20":
{
"coin" :"trx",
"receive_amount":"23092870.028105",
"send_amount":"1242995.611177",
"hot_address_amount":"357014.388823",
"settlement_amount":"23033124.2080808",
"wait_settlement_amount":"59745.8200242"
}
],
"date_time":"2020-09-07 11:12:49",
"time_stamp":1599448369
}
- Query: Merchant's total deposit, total withdrawal, total settlement, etc.
HTTP Request
POST /v2/balance/generalAccount
Request Parameters
This API has no business parameters; the request body is {}. For the common headers see Signature Regulations.
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| status | integer | status code |
| msg | string | state description |
| data | object | For details, see "data details" below. |
| data.coin | string | coin name |
| data.receive_amount | string | The total amount of deposits on the chain |
| data.send_amount | string | The total amount of on-chain withdrawals |
| data.hot_address_amount | string | Hot wallet balance |
| data.settlement_amount | string | Amount settled to merchant |
| data.wait_settlement_amount | string | Amount to be settle to the merchant |
| date_time | string | response time |
| time_stamp | integer | unix timestamp in second |
Merchant deposit/withdrawal successful number
Request example:
POST <base_path>/v2/statistics/transfer 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/statistics/transfer", map[string]any{
"coin": "eth",
})
$resp = $client->post('/v2/statistics/transfer', [
'coin' => 'eth',
]);
const resp = await client.post('/v2/statistics/transfer', {
coin: 'eth',
});
String resp = client.post("/v2/statistics/transfer", Map.of("coin", "eth"));
Example of return result:
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": "Processing successful",
"data": {
"success_send_count": 60,
"success_receive_count": 57
},
"date_time": "2020-06-02 16:52:05",
"time_stamp": 1591087925
}
- Query the number of successfully processed deposits/withdrawals
HTTP Request
POST /v2/statistics/transfer
Request Parameters
For the common headers see Signature Regulations; the table below lists only the business parameters in the body.
| Parameter | Required | Type | Description |
|---|---|---|---|
| coin | No | string | coin name (eg: eth, usdt_erc20) |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| status | integer | status code |
| msg | string | state description |
| data | object | For details, see "data details" below. |
| data.success_send_count | integer | number of successful withdrawals |
| data.success_receive_count | integer | number of successful deposits |
| date_time | string | response time |
| time_stamp | integer | unix timestamp in second |