5. Place order

This interface is used to create an order. You can create an order with up to 5 receiving addresses.

POST

/openapi/order/place

The order interface can have a maximum of 5 receiving addresses

Name	Type	Required	Description
Ref-Code	string	no	Referral code for the affiliate program; including this field will earn you a share of the profits.

1. Participation Requirements: If your API is part of an affiliate program, you are eligible to participate in referral code profit sharing.

2. Operation method: When placing an order via API, simply include the Ref-Code field in the Request Header.

Header

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

Request

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	Exchange mode [ float \| fixed ]
from_abbr	string	yes	Coin name
from_chain	string	yes	Chain name
from_quantity	float	yes	Quantity (minimum: 1e-8)
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.

Request

{
"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
  }
]
}

Response

Name	Type	Description
code	int	Business status code
data	object	Data Objects
address	string	Wallet Address
order_no	string	Order number
query_code	string	Query code
msg	string	Business message

Example Response

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