单位转换

API说明

此接口允许在合约交易中进行合约单位（张数）和加密货币（币）之间的转换。

注意：单位转换数据只能通过 RESTful API可用。

注意事项

无

认证

这是一个私有接口，需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。

请求方法

POST

接口地址

/v1/perpum/pieceConvert

频率限制

该接口的调用频率限制为：每个 IP 和用户 ID 每2秒最多请求10次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数

参数	必填	类型	描述
convertType	true	Long	转换类型：1：将合约单位（张数）转换为币，2：将币转换为合约单位（张数）注意：对于"1"：dealPiece是必需的，对于"2"：baseSize是必需的
dealPiece	false	BigDecimal	合约数量
faceValue	true	BigDecimal	每手最小价值
baseSize	false	BigDecimal	面值*份数（币的数量）

响应参数

参数	类型	描述
value	BigDecimal	合约或币的值

请求示例

以下Python代码展示了如何将合约转换为币。

注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。

params = {
          "convertType": 1,
          "dealPiece": 11,
          "faceValue": 0.001,
         }
api_url = "/v1/perpum/pieceConvert"
method = "POST"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)     # function FuturesRestfulPrivate() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface)

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful私有接口。

响应示例

以下是上述Python请求返回的示例响应：

{'code': 0, 'data': {'value': 0.011}, 'msg': ''}