doc error + cancel_order vs flash_close_position?

[gvdhoven]

@tyler663 @BitunixOfficial

I am succesfully able to create trades (via /api/v1/futures/trade/place_order).
In case this is a limit order, i get returned an orderId.
In case it is a market order, i assume i also get an orderId back?

But when I want to close this order, i am a bit stuck:

For pending trades, I can use /api/v1/futures/trade/cancel_orders

But what if the order is (partially or completely filled) ?
How do i close one specific position at market price and what happens to the order that is pending (in case of a partially filled order)?
Obviously i have checked the GitHub code, but there is no sample for getting the positionid or how to close orders that are running.

Some API's like the flash close, requires a parameter "positionID" and i don't know how to get that.

[tyler663]

You can try obtaining the ID first through the "Get Current Holdings" interface before proceeding with the operation.

[gvdhoven]

Hi @tyler663 thank you for your reply; what API call is that? I don't see it listed as such on the API docs.

[tyler663]

For position queries (positionId), you can use the endpoint /api/v1/futures/position/get_pending_positions without passing parameters. In case of partial closing, the position still exists so the positionId remains valid.
2.
For partially filled orders, query via /api/v1/futures/trade/get_pending_orders?symbol=SUIUSDT where order status shows as PART_FILLED.
3.
For canceled/fully filled orders, check historical orders at /api/v1/futures/trade/get_history_orders?symbol=BTCUSDT. The status for partially filled then canceled orders is PART_FILLED_CANCELED.
4.
Regarding partially filled orders - how are unfilled portions handled? Answer: This depends on the order strategy currently in effect.

[gvdhoven]

Thanx, this helps. Please correct me if i'm wrong:

When creating orders, i can pass in a "clientId" name to uniquely identify my order.

clientId | string | false | Customize order ID

However this doesn't return in get_pending_positions + you cannot query on this
https://openapidoc.bitunix.com/doc/position/get_pending_positions.html

Does Bitunix always have only '1' (running) order per symbol? e.g. multiple partially filled orders are merged into 1 trade?

[tyler663]

1.Multiple orders in the same direction for each trading instrument will be merged into a single position, identified by a positionId.
2.Each order creation will generate an orderId.
3.The clientId serves as a user-defined reference identifier.