Skip to main content
POST
/
api
/
v4
/
collateral-account
/
position
/
close
Close Position
curl --request POST \
  --url https://whitebit.com/api/v4/collateral-account/position/close \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --header 'X-TXC-PAYLOAD: <api-key>' \
  --header 'X-TXC-SIGNATURE: <api-key>' \
  --data '
{
  "positionId": 123,
  "positionSide": "LONG",
  "market": "BTC_USDT",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
{
  "code": 30,
  "message": "Validation failed",
  "errors": {}
}

Documentation Index

Fetch the complete documentation index at: https://whitebit-mintlify-fix-broken-links-1776643999.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

​
X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

​
X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

Body

application/json
​
positionId
integer
required

Unique identifier of the position to close. Obtain from the open positions endpoint.

Example:

123

​
market
string
required

Market of the position to close. Example: BTC_USDT

Example:

"BTC_USDT"

​
request
string
required
Example:

"{{request}}"

​
nonce
string
required
Example:

"{{nonce}}"

​
positionSide
enum<string>

Defines the position direction when hedge mode is enabled. See positionSide

Available options:
LONG,
SHORT,
BOTH
Example:

"LONG"

Response

Position closed