创建限价订单

post
https://api.cryptomus.com/v2/user-api/convert/limit
复制

要求

查询参数

姓名参数类型定义
from*stringmax:10转换货币（来源）
to*stringmax:10转换货币（目标）
amount*string需要在来源货币中转换的金额如果金额中有便士，请与分离器一起发送。
示例：10.28
price*string转换价格如果金额中有便士，请与分离器一起发送。
示例：10.28

参数类型

stringmax:10

定义

转换货币（来源）

参数类型

stringmax:10

定义

转换货币（目标）

参数类型

string

定义

需要在来源货币中转换的金额如果金额中有便士，请与分离器一起发送。
示例：10.28

参数类型

string

定义

转换价格如果金额中有便士，请与分离器一起发送。
示例：10.28

* - 强制性参数

请求示例

curl https://api.cryptomus.com/v2/user-api/convert/limit \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
        "from": "BTC",
        "to": "USDT",
        "amount": "0.0001",
        "price": "70000"
    }'
复制

回复

响应参数

姓名定义
order_id转换 ID
convert_amount_from转换金额（来源）
convert_amount_to转换金额（目标）
executed_amount_to执行金额（目标）
executed_amount_from执行金额（来源）
convert_currency_from转换货币（来源）
convert_currency_to转换货币（目标）
type类型枚举可用选项：• market• limit
status状态枚举可用选项：• active• completed• partially_completed• cancelled• expired• failed
created_at创建日期和时间
current_rate当前汇率
limit限制值（仅限类型为限制时）
expires_at限制到期日期和时间
completed_at订单完成日期和时间（仅当订单完成时）

定义

转换 ID

定义

转换金额（来源）

定义

转换金额（目标）

定义

执行金额（目标）

定义

执行金额（来源）

定义

转换货币（来源）

定义

转换货币（目标）

定义

类型枚举可用选项：- market- limit

定义

状态枚举可用选项：- active- completed- partially_completed- cancelled- expired- failed

定义

创建日期和时间

定义

当前汇率

定义

限制值（仅限类型为限制时）

定义

限制到期日期和时间

定义

订单完成日期和时间（仅当订单完成时）

响应示例


1{
2  "state": 0,
3  "result": {
4    "order_id": "2d9bf426-98ef-448b-84c2-03cc1ec78feb",
5    "convert_amount_from": "10.000",
6    "convert_amount_to": "3.000",
7    "executed_amount_from": null,
8    "executed_amount_to": null,
9    "convert_currency_from": "USDT",
10    "convert_currency_to": "XMR",
11    "type": "market",
12    "status": "completed",
13    "created_at": "2024-07-11 , 18:06:04",
14    "current_rate": "100",
15    "completed_at": "2024-07-11 , 18:06:04"
16  }
17}
复制