5. Create order

此接口用於創建訂單。您可以創建一個最多包含 5 個接收地址的訂單。

POST

/openapi/order/place

訂單接口最多可有 5 個接收地址

Name	Type	Required	Description
Ref-Code	string	no	聯盟計劃的推薦碼；填寫此欄位即可獲得部分利潤。

1.參與要求：如果您的 API 是聯盟計畫的一部分，您就有資格參與推薦碼利潤分成。

2. 操作方法：透過 API 下單時，只需在請求頭中包含 Ref-Code 字段即可。

請求头

{
  Ref-Code: "UtZ***P9"
}
  

請求

calc_id is an optional parameter; if this parameter is passed, a fixed exchange rate must be used, otherwise an error will be triggered.

If the passed calc_id has expired or does not exist, an error will be returned: {"code":1,"msg":"calc_id invalid or expired"}.

Name	Type	Required	Description
exchange_mode	string	yes	兌換模式（浮動比例 \| 固定比例）
from_abbr	string	yes	Coin name
from_chain	string	yes	Chain name
from_quantity	float	yes	數量
calc_id	string	no	The calc_id is valid for 30 seconds
to_address	array	yes	Receiving Address list
to_abbr	string	yes	Receive coin name
to_address	string	yes	Receiving Address
to_chain	string	yes	Receiving chain name
to_ratio	float	yes	The percentage of received assets out of source assets (0-1) represents 0% - 100%. If it's a 1-for-1 exchange, this parameter can be left blank and defaults to 1.

請求

{
"exchange_mode": "fixed",
"from_abbr": "ARB",
"from_chain": "Arbitrum",
"from_quantity": 100,
"calc_id": "c294e5e1-7fea-46d4-945f-b2e4aa695e4f"
"to_address": [
  {
    "to_abbr": "ETH",
    "to_address": "************",
    "to_chain": "Arbitrum",
    "to_ratio": 1
  }
]
}

響應

Name	Type	Description
code	int	業務狀態碼
data	object	數據對象
address	string	地址
order_no	string	訂單編號
query_code	string	查詢代碼
msg	string	業務消息

示例響應

{
"code": 0,
"msg": "success",
"data": {
  "order_no": "XUcQdnSg",
  "address": "TXf94kgP9HuVHr1bRLmHaL1hVPbUYipDGh",
  "query_code": "3XXNCL8PXZX6",
}
}