> ## 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.

# Transfer and conversion

> Spot API: transfer and conversion.

## Transfer between user business systems

`POST` `/v4/balance/transfer`

**Parameters**

| Parameter | Type | mandatory | Default | Description | Ranges |
| - | - | - | - | - | - |
| bizId | string | true | | Unique id for idempotent processing | Maximum length is 128 |
| from | enum | true | | Fund transfer out account | [bizType enmu](#bizType) |
| to | enum | true | | Fund transfer in account | [bizType enum](#bizType) |
| currency | string | true | | Currency name must be all lowercase (usdt,btc) | |
| symbol | string | false | | The transfer symbol must be all lowercase (this field must be passed if one of the transfer-in and transfer-out parties is leverage) | |
| amount | bigDecimal | true | | Transfer amount | |

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


}
```

```json Response theme={null}
{
  "rc": 0,
  "mc": "SUCCESS",
  "ma": [],
  "result": 123456 //The returned unique id of the transfer, it is recommended to store it for reconciliation
}
```

## Transfer between sub-account business systems

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

**Parameters**

| Parameter | Type | mandatory | Default | Description | Ranges |
| - | - | - | - | - | - |
| bizId | string | true | | Unique id for idempotent processing | Maximum length is 128 |
| from | enum | true | | Fund transfer out account | [bizType enmu](#bizType) |
| to | enum | true | | Fund transfer in account | [bizType enum](#bizType) |
| currency | string | true | | Currency name must be all lowercase (usdt,btc) | |
| symbol | string | false | | The transfer symbol must be all lowercase (this field must be passed if one of the transfer-in and transfer-out parties is leverage) | |
| amount | bigDecimal | true | | Transfer amount | |
| toAccountId | long | true | | Transfer-in account id (must belong to the same user as the transfer-out account ID) | |
| fromAccountId | long | false | | Transfer-out account id | |

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


}
```

```json Response theme={null}
{
  "rc": 0,
  "mc": "SUCCESS",
  "ma": [],
  "result": 123456 //The returned unique id of the transfer, it is recommended to store it for reconciliation
}
```

## Query Convertible Small Assets

`GET` `/balance/convert/evaluate`

### Limit Flow Rules

1/s/apikey

```json Response theme={null}
{
  "rc": 0,
  "mc": "string",
  "ma": [
    {}
  ],
  "result": {
                "details": [
                            {
                                "currency": "ADA",             // currency
                                "amount": "6.21",              // amount
                                "toBtc": "0.00016848",         // BTC Valuation
                                "convertAmount": "0.01777302", // Conversion Valuation (Before Fees Deduction)
                                "convertFee": "0.00035546"     // Conversion Valuation Fee
                            }
                ],
                "convertCurrency": "mcr",                       // Converted Currency Received
                "totalToBtc": "0.00016848",                    // Total BTC Valuation
                "totalConvertAmount": "0.01777302",            // Total Conversion Valuation (Before Fees Deduction)
                "totalConvertFee": "0.02"                      // Total Conversion Valuation Fee
  }
}
```

## Small Assets Conversion

`POST` `/balance/convert`

**Parameters**

| Parameter | Type | mandatory | Default | Description | Ranges |
| - | - | - | - | - | - |
| currencies | array | true | | collection | Up to 5 currencys can be converted |

### Limit Flow Rules

1/s/apikey

### Remark

Can only be converted once every 24 hours

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

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

## Query Small Assets Conversion List

`GET` `/balance/convert/list`

**Parameters**

| Parameter | Type | mandatory | Default | Description | Ranges |
| - | - | - | - | - | - |
| currency | string | true | | currency eg: usdt | |
| startTime | number | true | | start time | |
| endTime | number | true | | end time | |

### Limit Flow Rules

1/s/apikey

### Remark

Return only the latest 100 records

```json Response theme={null}
{
  "rc": 0,
  "mc": "string",
  "ma": [
    {}
  ],
  "result": [
                {
                    "currency": "ADA",          // currency
                    "amount": "6.21",           // amount
                    "convertAmount": "6.21",    // convert amount
                    "convertCurrency": "mcr",    // convert currency
                    "convertFee": "0.00035546", // convert fee
                    "createTime": 1615985535000 // create time
                }
            ]
}
```


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