Place Order
POST
/api/v1/orderPlace Order allows users to place a specific order on our platform. To utilize this API, follow the Poseidon Signature Guide to generate the necessary body parameters and timestamp for the header. Input the generated values and proceed to test our Place Order API.
Note: Please ensure that you have followed the Poseidon Signature Guide accurately to create a valid signature. The timestamp in the header must not be earlier than the order placement request timestamp by more than 60 seconds.
请求参数
The trading pair symbol (e.g., "WBTCUSDT") for which the order is placed.
Specifies the order side, either "BUY" for a buy order or "SELL" for a sell order.
Specifies the order type. "LIMIT" for a limit order.
Specifies the time in force for the order. "GTC" for Good Til Canceled, "FOK" for Fill Or Kill, and "IOC" Immediate Or Cancel.
The quantity of the asset to be bought or sold in the order.
The price at which the order should be executed.
A unique identifier assigned by the client to this order. It must be unique for each new order.
The cryptographic signature generated using the Poseidon algorithm. Refer to the Poseidon Signature Guide for details on generating the signature.
Specifies the response type for the new order.
"FULL" will respond with detailed information about the new order, including all relevant details.
"RESULT" will respond with only the basic result of the order placement.
"ACK" will respond with a quick acknowledgment that the order has been received and is being processed. However, the response will not include the detailed information about the order's status or execution.
{
"symbol": "WBTCUSDT",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTC",
"quantity": 0.12,
"price": 36000,
"clientOrderId": "1701772026638",
"signature": "0xd448022ed479ff946790d172ad21b4e42ad3647ac0c2a73151ffa45242bc9a093462368dafd45725d75f530c519201110f87a074167a5eb7c773d3fa99d3f66c",
"newOrderRespType": "FULL"
}
示例代码
Responses
Indicates whether there is an error in the order placement. If false, the order placement was successful.
The unique identifier assigned to the newly placed order.
The trading pair symbol for which the order was placed (e.g., "WBTCUSDT").
The timestamp when the order transaction occurred (Unix timestamps in milliseconds & UTC).
The timestamp when the order started processing (Unix timestamps in milliseconds & UTC).
The original quantity specified in the order.
The type of order (e.g., "LIMIT").
The side of the order (e.g., "BUY" or "SELL").
The price specified in the order.
The time in force for the order. "GTC" for Good Til Canceled, "FOK" for Fill Or Kill, and "IOC" Immediate Or Cancel.
The quantity of the order that has been executed.
The current status of the order.
NEW: The order has been created and is awaiting processing.
PARTIALLY_FILLED: The order has been partially filled.
FILLED: The order has been completely filled.
CANCELED: The order has been canceled.
REJECTED: The order has been rejected.
EXPIRED: The order has expired.
Details of the fills that occurred during the order execution.
The action associated with the fill, indicating the nature of the transaction (e.g., "TRADE", "REJECT", "REDUCE").
The price at which the fill occurred.
The quantity of the asset filled in the transaction.
{
"error": false,
"orderId": 3595449,
"symbol": "WBTCUSDT",
"transactTime": 1706513190497,
"workingTime": 1706513190498,
"origQty": 0.01,
"type": "LIMIT",
"side": "BUY",
"price": 43000,
"timeInForce": "GTC",
"executedQty": 0.01,
"status": "FILLED",
"fills": [
{
"action": "TRADE",
"price": 42251.91,
"qty": 0.01
}
]
}