It is necessary to package the data in the parameter table into JSON strings and use rsa for parameter encryption and signature as data and sign in the body
Headers
Name
Type
Description
Content-Type *
String
application/json
Request Body
Name
Type
Description
app_id*
String
Merchant AppKey
time*
String
sign*
String
data*
String
{
"code": "",
"msg": "",
"data": "",
"sign": ""
}
data:
{
"BTCPrecision": "btc8", // Currency parameter + precision: Precision of the currency in the exchange
"accounts": [
{
"uid": "202113", // User ID
"balance": "1000", // Account balance
"tag": "xxxxx", // Description
"type": "2021101" // Asset code
},
{
"uid": "202113", // User ID
"balance": "1000", // Account balance
"tag": "xxxxx", // Description
"type": "2021101" // Asset code
}
],
"USDTPrecision": "usdt8" // Currency parameter + precision: Precision of the currency in the exchange
}
The following are the parameters involved in rsa encryption:
Either the UID or OpenID of the payee must exist, and if both are present, the OpenID takes precedence.
name
type
required
example
Description
openId
String
NO
openId, userId must pass one, while passing, take openId
userId
String
NO
openId, userId must pass one, while passing, take openId
coinSymbols
String
YES
BTC
Currency type: e.g. BTC, USDT, BIKI, etc.; refer to the currency configuration in the exchange; multiple currencies are separated by commas: Example: "USDT,BTC,ETH"
It is necessary to package the data in the parameter table into JSON strings and use rsa for parameter encryption and signature as data and sign in the body
Headers
Name
Type
Description
Content-Type *
String
application/json
Request Body
Name
Type
Description
app_id*
String
Merchant AppKey
time*
String
data*
String
sign*
String
{
"code": "", //Return code
"msg": "", //Success or failure message
"data": "",
"sign": ""
}
data:
{
"totalBalance": "100", // Total assets
"totalBalanceSymbol": "BTC", // Total asset symbol
"platformCoin": "xxx", // Platform coin for dividend configuration
"allCoinMap": { // Mapping of all coins, where the key is the uppercase coin symbol and the value is the asset details for each coin
"LTC": {
"walletTransactionOpen": 1, // Whether the coin has wallet transaction enabled
"isFiat": 0, // Whether it is a fiat currency, 0 for digital currency, 1 for fiat
"normal_balance": "200", // User's normal spot balance
"allBalance": "9000", // Total balance
"exchange_symbol": "Trading pair", // Trading pair symbol
"present_coin_balance": 9000, // Gift coin account
"lock_position_balance": "2000", // Lock position account
"btcValuatin": "10000", // BTC valuation
"sort": 20, // Sorting order
"depositOpen": 1, // Whether deposit is open
"lock_grant_divided_balance": "999999", // User's token lock + mining lock balance
"total_balance": "99999", // Total balance
"nc_lock_balance": "98888", // User's subscription frozen balance
"otcOpen": 1, // Whether OTC is open
"depositMin": 20, // Minimum deposit amount
"checked": "true", // Whether to hide zero assets, default to true
"coinName": "name", // Name
"lock_balance": "3000", // Frozen amount
"allBtcValuatin": "9918923", // All BTC valuation
"lock_position_v2_amount": "203213", // User's token lock account V2
"withdrawOpen": 1, // Whether withdrawal is open
"overcharge_balance": "9000"
},
"BCH": {
"walletTransactionOpen": 1, // Whether the coin has wallet transaction enabled
"isFiat": 0, // Whether it is a fiat currency, 0 for digital currency, 1 for fiat
"normal_balance": "200", // User's normal spot balance
"allBalance": "9000", // Total balance
"exchange_symbol": "Trading pair", // Trading pair symbol
"present_coin_balance": 9000, // Gift coin account
"lock_position_balance": "2000", // Lock position account
"btcValuatin": "10000", // BTC valuation
"sort": 20, // Sorting order
"depositOpen": 1, // Whether deposit is open
"lock_grant_divided_balance": "999999", // User's token lock + mining lock balance
"total_balance": "99999", // Total balance
"nc_lock_balance": "98888", // User's subscription frozen balance
"otcOpen": 1, // Whether OTC is open
"depositMin": 20, // Minimum deposit amount
"checked": "true", // Whether to hide zero assets, default to true
"coinName": "name", // Name
"lock_balance": "3000", // Frozen amount
"allBtcValuatin": "9918923", // All BTC valuation
"lock_position_v2_amount": "203213", // User's token lock account V2
"withdrawOpen": 1, // Whether withdrawal is open
"overcharge_balance": "9000"
}
}
}
The following are the parameters involved in rsa encryption:
(openId, userId, mobileNumber, email) One of these four must be provided.
name
type
是否required
例子
Description
openId
String
NO
openId, userId must pass one, while passing, take openId
userId
String
NO
openId, userId must pass one, while passing, take openId
mobileNumber
String
NO
09011223
Cell phone number
email
String
NO
xxxxx@.com
Useremail(openId,userId,mobileNumber,email)Four choices are required
It is necessary to package the data in the parameter table into JSON strings and use rsa for parameter encryption and signature as data and sign in the body
{
"code": "",
"msg": "",
"data": "",
"sign":""
}
data:
[
{
"code": "0",
"msg": "Success",
"data": {
"BTCPrecision": "btc8", // Currency parameter + precision: Precision of the currency in the exchange
"accounts": [
{
"uid": "202113", // User ID
"balance": "1000", // Account balance
"tag": "xxxxx", // Description
"type": "2021101" // Asset code
},
{
"uid": "202113", // User ID
"balance": "1000", // Account balance
"tag": "xxxxx", // Description
"type": "2021101" // Asset code
}
],
"USDTPrecision": "usdt8" // Currency parameter + precision: Precision of the currency in the exchange
}
}
]
Parameters:
Either the UID or OpenID of the payee must exist, and if both are present, the OpenID takes precedence.
name
type
required
example
Description
appKey
String
YES
xxx_xxx
Merchant AppKey
openId
String
NO
openId, userId must pass one, while passing, take openId
userId
String
NO
openId, userId must pass one, while passing, take openId
coinSymbols
String
YES
BTC
Currency type: e.g. BTC, USDT, BIKI, etc.; refer to the currency configuration in the exchange; multiple currencies are separated by commas: Example: "USDT,BTC,ETH"
{
"code": "",
"msg": "",
"data": "",
"sign":""
}
data:[
{
"code": "0",
"msg": "Success",
"data": {
"accounts": [
{
"uid": "202113", // User ID
"balance": "1000", // Account balance
"type": "202" // Asset code
"coin": "USDT", // coin name
"showName": "USDT" // coin show name
},
{
"uid": "202113", // User ID
"balance": "1000", // Account balance
"type": "201" // Asset code
"coin": "USDT", // coin name
"showName": "USDT" // coin show nam
}
],
}
}
]
//"Type" refers to the corresponding account type
type = 201(User: Normal Balance)
type = 202(User: Frozen)
type = 207(Lockup Account)
type = 210(OTC Merchant Margin Account)
type = 217(User: OTC Normal Balance)
type = 218(User: OTC Frozen)
type = 230(User: Lockup token account V2)
type = 221(User: Frozen token from Innovation trial zone subscription)
Parameters:
Name
Type
Description
appKey*
String
Merchant AppKey
sign*
String
Signature
coinSymbols*
String
Currency type: e.g. BTC, USDT, BIKI, etc.; refer to the currency configuration in the exchange; multiple currencies are separated by commas: Example: "USDT,BTC,ETH"
updateTime
String
Update the time, check for this timestamp and accounts that have changed in the future. If the time when the time changes is not specified, the system starts to pull all data from the site
page
String
Page number, default 1
pageSize
String
Page size,default 20 ,Maximum support to1000
Parameters:
updateTime is a required parameter, Taking two queries as an example, first time 2023-09-01 00:00:00 second time 2023-09-01 00:10:00
first query:
account table record
ID
uid
balance
type
changeTime
1
1
10
201
2023-09-01 00:00:00
2
2
2
201
2023-09-01 00:00:00
3
1
2
202
2023-09-01 00:00:00
4
2
5
202
2023-09-01 00:02:00
5
3
5
201
2023-09-01 00:02:00
6
4
5
201
2023-09-01 00:02:00
7
6
5
201
2023-09-01 00:02:00
8
7
5
201
2023-09-01 00:02:00
9
8
5
201
2023-09-01 00:02:00
2023-09-01 00:00:00 timestemp: 1693497600000
current params is {"updateTime":1693497600000, coinSymbols: "btc,eth","page":1, "pageSize": 5}
The records found are id (1,2,3,4,5)
If the number of results is less than pageSize, end the loop
Found 5 records for pagination query. The query criteria are {"updateTime":1693497600000, coinSymbols: "BTC,ETH","page":2, "pageSize": 5} The records found are id (6,7,8,9)
second query:
account table record
ID
uid
balance
type
changeTime
1
1
12
201
2023-09-01 00:10:00
2
2
2
201
2023-09-01 00:00:00
3
1
0
202
2023-09-01 00:10:00
4
2
5
202
2023-09-01 00:02:00
5
3
5
201
2023-09-01 00:02:00
6
4
5
201
2023-09-01 00:02:00
7
6
5
201
2023-09-01 00:02:00
8
7
5
201
2023-09-01 00:02:00
9
8
5
201
2023-09-01 00:02:00
2023-09-01 00:10:00 timestemp: 1693498200000
current params is {"updateTime":1693498200000, coinSymbols: "BTC,ETH","page":1, "pageSize": 5} The records found are id (1,3)