Change Position Mode

Type: TRADE

Weight: 1 (POST) / 30 (GET)

GET /fapi/v1/positionSide/dual · POST /fapi/v1/positionSide/dual

Query or set hedge mode. Sparky runs one-way mode only.

GET

GET /fapi/v1/positionSide/dual?timestamp=<ms>&signature=<hex>

{ "dualSidePosition": false }

POST

POST /fapi/v1/positionSide/dual?timestamp=<ms>&signature=<hex>
Content-Type: application/json
{ "dualSidePosition": false }

dualSidePosition	Result
false (or "false", 0, "0", "")	{ "code": 200, "msg": "success" } (idempotent)
true	{ "code": -4059, "msg": "Hedge mode (dualSidePosition=true) is not supported. This exchange runs in one-way mode only." }

Earlier builds accepted true while still reporting false on GET, which broke reconciliation; the request is now hard-rejected. Never send true.

Authentication failures (INVALID_API_KEY, API_KEY_DISABLED, IP_NOT_ALLOWED, SIGNATURE_INVALID) apply to every signed endpoint and use Sparky's {"success":false,"error":{...}} envelope; see Error Codes.