> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monochrome.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# 划转与小额资产兑换

> 现货 API：划转与小额资产兑换。

## 用户业务系统间划转

`POST` `/v4/balance/transfer`

**Parameters**

| 参数 | 数据类型 | 是否必须 | 默认值 | 描述 | 取值范围 |
| - | - | - | - | - | - |
| bizId | string | true | | 唯一id 用作重复请求幂等 | 最大长度为128 |
| from | enum | true | | 划出业务账户 | bizType 枚举 |
| to | enum | true | | 划入业务账户 | bizType 枚举 |
| currency | string | true | | 币种名称必须全部小写（usdt，btc） | |
| symbol | string | false | | 划转交易对必须全部小写（划入划出有一方是杠杆此字段必传） | |
| amount | bigDecimal | true | | 划转的数量 | |

```java Java theme={null}
public String transferPost(){


}
```

```python Python theme={null}
```

```json Response theme={null}
{
  "rc": 0,
  "mc": "string",
  "ma": [],
  "result": 123456  //返回的划转唯一id 建议存储用来对账
}
```

## 子账户业务系统间划转

`POST` `/v4/balance/account/transfer`

**Parameters**

| 参数 | 数据类型 | 是否必须 | 默认值 | 描述 | 取值范围 |
| - | - | - | - | - | - |
| bizId | string | true | | 唯一id 用作重复请求幂等 | 最大长度为128 |
| from | enum | true | | 划出业务账户 | bizType 枚举 |
| to | enum | true | | 划入业务账户 | bizType 枚举 |
| currency | string | true | | 币种名称必须全部小写（usdt，btc） | |
| symbol | string | false | | 划转交易对必须全部小写（划入划出有一方是杠杆此字段必传） | |
| amount | bigDecimal | true | | 划转的数量 | |
| toAccountId | long | true | | 划入账户id（必须和划出账户id属于同一个用户否则不支持） | |
| fromAccountId | long | false | | 划出账户id | |

```java Java theme={null}
public String accountTransferPost(){


}
```

```python Python theme={null}
```

```json Response theme={null}
{
  "rc": 0,
  "mc": "SUCCESS",
  "ma": [],
  "result": 123456 //返回的划转唯一id 建议存储用来对账
}
```

## 查询可以转换的小额资产

`GET` `/balance/convert/evaluate`

### 限流规则

1/s/apikey

```json Response theme={null}
{
  "rc": 0,
  "mc": "string",
  "ma": [
    {}
  ],
  "result": {
                "details": [
                            {
                                "currency": "ADA",             // 币种名称
                                "amount": "6.21",              // 数量
                                "toBtc": "0.00016848",         // BTC估值
                                "convertAmount": "0.01777302", // 转换估值（未扣除手续费）
                                "convertFee": "0.00035546"     // 转换估值手续费
                            }
                ],
                "convertCurrency": "mcr",                       // 转换币种
                "totalToBtc": "0.00016848",                    // BTC总估值
                "totalConvertAmount": "0.01777302",            // 转换总估值（未扣除手续费）
                "totalConvertFee": "0.02"                      // 转换总估值手续费
  }
}
```

## 小额资产转换

`POST` `/balance/convert`

**Parameters**

| 参数 | 数据类型 | 是否必须 | 默认值 | 描述 | 取值范围 |
| - | - | - | - | - | - |
| currencies | array | true | | 集合 | 最多支持5个加密币转换 |

### 限流规则

1/s/apikey

### 备注

24小时只能兑换一次

```java Java theme={null}
{
    "currencies": [
        "usdt",
        "btc",
        "eth"
    ]
}
```

```python Python theme={null}
```

```json Response theme={null}
{
  "rc": 0,
  "mc": "string",
  "ma": [
    {}
  ],
  "result": {
              
  }
}
```

## 查询小额资产转换列表

`GET` `/balance/convert/list`

**Parameters**

| 参数 | 数据类型 | 是否必须 | 默认值 | 描述 | 取值范围 |
| - | - | - | - | - | - |
| currency | string | true | | 加密币 eg:  usdt | |
| startTime | number | true | | 开始时间 | |
| endTime | number | true | | 结束时间 | |

### 限流规则

1/s/apikey

### 备注

只返回最新的100条数据

```json Response theme={null}
{
  "rc": 0,
  "mc": "string",
  "ma": [
    {}
  ],
  "result": [
                {
                    "currency": "ADA",          // 币种名称
                    "amount": "6.21",           // 数量
                    "convertAmount": "6.21",    // 转换数量
                    "convertCurrency": "mcr",    // 转换币种
                    "convertFee": "0.00035546", // 手续费
                    "createTime": 1615985535000 // 操作时间
                }
            ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.