> For the complete documentation index, see [llms.txt](https://platformv2docs.chainup.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://platformv2docs.chainup.com/yong-hu-zi-chan-jie-kou.md).

# 用户资产接口

## 用户资产查询（单币种） <a href="#yong-hu-zi-chan-cha-xun-dan-bi-zhong" id="yong-hu-zi-chan-cha-xun-dan-bi-zhong"></a>

## 用户资产查询（单币种）

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/ouser/userAccounts`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| Content-Type	<mark style="color:red;">\*</mark> | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体

{
    "BTCPrecision": "btc8", //币种参数 + precision ： 该币种交易所精度 
    "accounts": [
      {
        "uid": "202113",//用户id
        "balance": "1000", //账号余额 
        "tag": "xxxxx", //描述  
        "type": "2021101" //资产编号 
      },
      {
        "uid": "202113",//用户id
        "balance": "1000", //账号余额 
        "tag": "xxxxx", //描述  
        "type": "2021101" //资产编号 
      }
    ],
    "USDTPrecision": "usdt8" //币种参数 + precision ： 该币种交易所精度 
}
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

收款用户uid与openid必须存在一个,同时存在优先取openid

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>openId</td><td>String</td><td>NO</td><td></td><td>收款用户的唯一id，开放平台授权给应用的用户唯一标识</td></tr><tr><td>userId</td><td>String</td><td>NO</td><td></td><td>收款用户uid(与openid必须存在一个) ||同时存在优先取openid</td></tr><tr><td>coinSymbols</td><td>String</td><td>YES</td><td>BTC</td><td>货币类型：如 ：BTC、USDT、BIKI、等；参考交易所内币种配置；多个币种用逗号分隔：例："USDT,BTC,ETH"</td></tr><tr><td>assetType</td><td>String</td><td>NO</td><td>201</td><td>常用类型："201" ：普通账户余额</td></tr></tbody></table>

## 用户账户余额（全币种） <a href="#u7528u6237u8d26u6237u4f59u989duff08u5168u5e01u79cduff090a3ca20id3du7528u6237u8d26u6237u4f59u989duff0" id="u7528u6237u8d26u6237u4f59u989duff08u5168u5e01u79cduff090a3ca20id3du7528u6237u8d26u6237u4f59u989duff0"></a>

<mark style="color:green;">`POST`</mark> `https://service.xxx.om//platformapi/chainup/open/user/accountBalance`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| Content-Type	<mark style="color:red;">\*</mark> | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体
java
{
    "totalBalance": "100",//总资产
    "totalBalanceSymbol": "BTC",//总资产币种
    "platformCoin": "xxx",//分红配置的平台币
    "allCoinMap": { // 所有币种的映射，key是币种名字大写，value是每个币种对应的资产详情，
      "LTC": {
        "walletTransactionOpen": 1,//币种是否开启钱包划转
        "isFiat": 0 // 是否为法币，0:数字货币，1法币
        "normal_balance": "200", //用户现货正常余额
        "allBalance": "9000",//所有余额
        "exchange_symbol": "交易币对",//交易币对
        "present_coin_balance": 9000,//赠币账户
        "lock_position_balance": "2000",//锁仓账户
        "btcValuatin": "10000",//BTC折合
        "sort": 20,//排序
        "depositOpen": 1,//是否打开充值
        "lock_grant_divided_balance": "999999",//用户代币锁仓+挖矿锁仓账户余额
        "total_balance": "99999",//总余额
        "nc_lock_balance": "98888",//用户申购冻结余额
        "otcOpen": 1,//是否开启场外
        "depositMin": 20,//最小充值金额
        "checked": "true",//是否隐藏零资产，默认给true
        "coinName": "name", // 名字
        "lock_balance": "3000", //冻结金额
        "allBtcValuatin": "9918923",//所有折合btc
        "lock_position_v2_amount": "203213",//用户代币锁仓账户V2
        "withdrawOpen": 1, //是否开启提现
        "overcharge_balance": "9000"
      },
      "BCH": {
        "walletTransactionOpen": 1,//币种是否开启钱包划转
        "isFiat": 0 // 是否为法币，0:数字货币，1法币
        "normal_balance": "200", //用户现货正常余额
        "allBalance": "9000",//所有余额
        "exchange_symbol": "交易币对",//交易币对
        "present_coin_balance": 9000,//赠币账户
        "lock_position_balance": "2000",//锁仓账户
        "btcValuatin": "10000",//BTC折合
        "sort": 20,//排序
        "depositOpen": 1,//是否打开充值
        "lock_grant_divided_balance": "999999",//用户代币锁仓+挖矿锁仓账户余额
        "total_balance": "99999",//总余额
        "nc_lock_balance": "98888",//用户申购冻结余额
        "otcOpen": 1,//是否开启场外
        "depositMin": 20,//最小充值金额
        "checked": "true",//是否隐藏零资产，默认给true
        "coinName": "name", // 名字
        "lock_balance": "3000", //冻结金额
        "allBtcValuatin": "9918923",//所有折合btc
        "lock_position_v2_amount": "203213",//用户代币锁仓账户V2
        "withdrawOpen": 1, //是否开启提现
        "overcharge_balance": "9000"
      }
    }
  }
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

(openId,userId,mobileNumber,email)四选一必填

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>openId</td><td>String</td><td>NO</td><td></td><td>收款用户的唯一id，开放平台授权给应用的用户唯一标识</td></tr><tr><td>userId</td><td>String</td><td>NO</td><td></td><td>收款用户uid(与openid必须存在一个) ||同时存在优先取openid</td></tr><tr><td>mobileNumber</td><td>String</td><td>NO</td><td>09011223</td><td>手机号码</td></tr><tr><td>email</td><td>String</td><td>NO</td><td>xxxxx@.com</td><td>用户邮箱</td></tr></tbody></table>

## 获取用户充值记录

## 获取用户充值记录

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/depositRecord`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| Content-Type	<mark style="color:red;">\*</mark> | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体
[
    {
      "symbol": "usdt", //充值币种  
      "id": 112331, //充值id  
      "uid": -230000, //充值用户id  
      "createdAt": 1233200092, //充值创建时间 
      "addressTo": "xxxxxxxxx", //充值地址  
      "amount": "1", //充值金额 
      "txid": "xxxxx", //txid 
      "status": 1, //充值状态 0 待确认，1 已完成 2 充值状态异常  
      "depositType": 0, //充值类型，0 外部充值 1 内部充值  
      "statusDesc": "xxxxx", //充值状态描述 
      "mobileNumber": "08666666", //用户手机号 
      "email": "xxxxx", //邮箱  
      "riskLevel": 0 //0:未检测到风险, 1:低风险, 2:中风险, 3:高风险
    },
    {
      "symbol": "bnb", //充值币种  
      "id": 112331, //充值id  
      "uid": -230000, //充值用户id  
      "createdAt": 1233200092, //充值创建时间 
      "addressTo": "xxxxxxxxx", //充值地址  
      "amount": "1", //充值金额 
      "txid": "xxxxx", //txid 
      "status": 1, //充值状态 0 待确认，1 已完成 2 充值状态异常  
      "depositType": 0, //充值类型，0 外部充值 1 内部充值  
      "statusDesc": "xxxxx", //充值状态描述 
      "mobileNumber": "08666666", //用户手机号 
      "email": "xxxxx", //邮箱  
      "riskLevel": 0 //0:未检测到风险, 1:低风险, 2:中风险, 3:高风险
    },
    {
      "symbol": "btc", //充值币种  
      "id": 112331, //充值id  
      "uid": -230000, //充值用户id  
      "createdAt": 1233200092, //充值创建时间 
      "addressTo": "xxxxxxxxx", //充值地址  
      "amount": "1", //充值金额 
      "txid": "xxxxx", //txid 
      "status": 1, //充值状态 0 待确认，1 已完成 2 充值状态异常  
      "depositType": 0, //充值类型，0 外部充值 1 内部充值  
      "statusDesc": "xxxxx", //充值状态描述 
      "mobileNumber": "08666666", //用户手机号 
      "email": "xxxxx", //邮箱  
      "riskLevel": 0 //0:未检测到风险, 1:低风险, 2:中风险, 3:高风险
    },
    {
      "symbol": "eth", //充值币种  
      "id": 112331, //充值id  
      "uid": -230000, //充值用户id  
      "createdAt": 1233200092, //充值创建时间 
      "addressTo": "xxxxxxxxx", //充值地址  
      "amount": "1", //充值金额 
      "txid": "xxxxx", //txid 
      "status": 1, //充值状态 0 待确认，1 已完成 2 充值状态异常  
      "depositType": 0, //充值类型，0 外部充值 1 内部充值  
      "statusDesc": "xxxxx", //充值状态描述 
      "mobileNumber": "08666666", //用户手机号 
      "email": "xxxxx", //邮箱  
      "riskLevel": 0 //0:未检测到风险, 1:低风险, 2:中风险, 3:高风险
    }
  ]
 
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

(openId,userId,mobileNumber,email)四选一必填

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>openId</td><td>String</td><td>NO</td><td></td><td>收款用户的唯一id，开放平台授权给应用的用户唯一标识</td></tr><tr><td>userId</td><td>String</td><td>NO</td><td></td><td>收款用户uid(与openid必须存在一个) ||同时存在优先取openid</td></tr><tr><td>mobileNumber</td><td>String</td><td>NO</td><td>09011223</td><td>手机号码</td></tr><tr><td>email</td><td>String</td><td>NO</td><td>xxxxx@.com</td><td>用户邮箱</td></tr><tr><td>pageSize</td><td>String</td><td>NO</td><td>20</td><td>每页数量(默认，20，最大1000，可以等于1000)</td></tr><tr><td>pageNumber</td><td>String</td><td>NO</td><td>1</td><td>页数（默认1，第一页）</td></tr></tbody></table>

## 用户提现记录 <a href="#yong-hu-ti-xian-ji-lu" id="yong-hu-ti-xian-ji-lu"></a>

## 用户提现记录

<mark style="color:green;">`POST`</mark> `https://service.xxx.com/platformapi/chainup/open/user/withdrawRecord`

需要将参数表格中的数据包装成json字符串 利用rsa 进行参数加密和签名 作为body中的data和sign

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                      | Type   | Description                  |
| ----------------------------------------- | ------ | ---------------------------- |
| app\_id<mark style="color:red;">\*</mark> | String | 商家唯一编号                       |
| time<mark style="color:red;">\*</mark>    | String | 请求时间                         |
| sign<mark style="color:red;">\*</mark>    | String | 用rsa\_third\_pri对query中的数据签名 |
| data<mark style="color:red;">\*</mark>    | String | rsa\_saas\_pub加密query中数据     |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "code": "", //返回code	
    "msg": "", //成功或失败提示信息	
    "data": "",
    "sign": ""
}

data 中解密后的结构体

[
    {
      "symbol": "BTC", //提现币种  
      "id": 1112, //提现id  
      "uid": 2302221, //用户id  
      "createdAt": 100892232313, //提现创建时间  
      "addressTo": "xxxxxxxxx", //提现地址 
      "amount": "20", //提现金额  
      "txid": "xxxxxxxxxx", //txid
      "status": 1, //提现状态   0未审核 1 审核通过 2审核拒绝 3支付中，已打币 4支付失败  5已完成  6已撤销 
      "statusDesc": "test", //提现状态描述  
      "fee": "20", //手续费  
      "mobileNumber": "19982112", //手机号  
      "email": "xxxx@.com", //邮箱
      "warningLevel": 1, //风控警告等级  
      "warningLevelDesc": "test", //警告等级提示  
      "warningTip": "resr", //报警内容 
      "warningTiplevel": 1 //商户后台报警等级展示 
    },
    {
      "symbol": "BTC", //提现币种  
      "id": 1112, //提现id  
      "uid": 2302221, //用户id  
      "createdAt": 100892232313, //提现创建时间  
      "addressTo": "xxxxxxxxx", //提现地址 
      "amount": "20", //提现金额  
      "txid": "xxxxxxxxxx", //txid
      "status": 1, //提现状态   0未审核 1 审核通过 2审核拒绝 3支付中，已打币 4支付失败  5已完成  6已撤销 
      "statusDesc": "test", //提现状态描述  
      "fee": "20", //手续费  
      "mobileNumber": "19982112", //手机号  
      "email": "xxxx@.com", //邮箱
      "warningLevel": 1, //风控警告等级  
      "warningLevelDesc": "test", //警告等级提示  
      "warningTip": "resr", //报警内容 
      "warningTiplevel": 1 //商户后台报警等级展示 
    }
  ]
```

{% endtab %}
{% endtabs %}

以下为参与rsa加密的参数:

(openId,userId,mobileNumber,email)四选一必填

<table><thead><tr><th width="136">名称</th><th width="124">类型</th><th>是否必需</th><th width="214">例子</th><th>描述</th></tr></thead><tbody><tr><td>openId</td><td>String</td><td>NO</td><td></td><td>收款用户的唯一id，开放平台授权给应用的用户唯一标识</td></tr><tr><td>userId</td><td>String</td><td>NO</td><td></td><td>收款用户uid(与openid必须存在一个) ||同时存在优先取openid</td></tr><tr><td>mobileNumber</td><td>String</td><td>NO</td><td>09011223</td><td>手机号码</td></tr><tr><td>email</td><td>String</td><td>NO</td><td>xxxxx@.com</td><td>用户邮箱</td></tr><tr><td>pageSize</td><td>String</td><td>NO</td><td>20</td><td>每页数量(默认，20，最大1000，可以等于1000)</td></tr><tr><td>pageNumber</td><td>String</td><td>NO</td><td>1</td><td>页数（默认1，第一页）</td></tr></tbody></table>