# 用户资产接口

## 用户资产查询（单币种） <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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://platformv2docs.chainup.com/yong-hu-zi-chan-jie-kou.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.