Skip to main content
GET
GET /v2/trade/perps/positions: Positions and TP/SL
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.

List positions

Open positions, with their take-profit and stop-loss. Scope perps.read.

Query Parameters

integer
Only the position on this instrument.

Example

Set take-profit and stop-loss

Sets the position’s take-profit and stop-loss, replacing what was armed. Scope trade.perps; Idempotency-Key is required.
A take-profit or stop-loss armed on a position stays armed until you cancel it by order_id with DELETE /v2/trade/perps/orders/{id} or replace it here. DELETE /v2/trade/perps/orders does not cancel it.

Path Parameters

string
required
The venue instrument id of the position.

Body

At least one of the two.
object
object

Errors

Every Perps code and its retry rule: Errors.

Example