Skip to main content
POST
/
api
/
v4
/
collateral-account
/
positions
Open Positions
curl --request POST \
  --url https://whitebit.com/api/v4/collateral-account/positions \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "market": "BTC_USDT",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
[
  {
    "positionId": 527,
    "market": "BTC_USDT",
    "openDate": 1651568067.789679,
    "modifyDate": 1651568067.789679,
    "amount": "0.1",
    "basePrice": "45658.349",
    "liquidationPrice": null,
    "liquidationState": "margin_call",
    "pnl": "-168.42",
    "pnlPercent": "-0.43",
    "margin": "8316.74",
    "freeMargin": "619385.67",
    "funding": "0",
    "unrealizedFunding": "0.0019142920201966",
    "tpsl": {
      "takeProfitId": 123,
      "takeProfit": "50000",
      "stopLossId": 124,
      "stopLoss": "35000"
    },
    "positionSide": "LONG"
  },
  {
    "positionId": 528,
    "market": "ETH_USDT",
    "openDate": 1651568067.789679,
    "modifyDate": 1651568067.789679,
    "amount": "0.1",
    "basePrice": "5658.349",
    "liquidationPrice": null,
    "liquidationState": "margin_call",
    "pnl": "-168.42",
    "pnlPercent": "-0.43",
    "margin": "8316.74",
    "freeMargin": "19385.67",
    "funding": "0",
    "unrealizedFunding": "0.0020142920201966",
    "tpsl": null,
    "positionSide": "LONG"
  }
]

Authorizations

​
X-TXC-APIKEY
string
header
required

API Key authentication for private endpoints.

Required headers:

  • X-TXC-APIKEY: API key
  • X-TXC-PAYLOAD: Base64 encoded JSON payload
  • X-TXC-SIGNATURE: HMAC SHA512 signature

Body

application/json
​
market
string

Filter by specific market. For example: BTC_USDT

If not specified, returns all open positions.

Example:

"BTC_USDT"

​
request
string

Request signature

Example:

"{{request}}"

​
nonce
string

Unique request identifier

Example:

"{{nonce}}"

Response

Successful response - returns array of open positions

​
positionId
integer

Unique position identifier

Example:

527

​
market
string

Market name

Example:

"BTC_USDT"

​
amount
string

Position amount

Example:

"0.1"

​
basePrice
string

Base price of position

Example:

"45658.349"

​
liqPrice
string | null

Liquidation price according to current state of position

Example:

"40000.00"

​
pnl
string

Unrealized profit and loss in money

Example:

"-168.42"

​
pnlPercent
string

Unrealized profit and loss in percentage

Example:

"-0.43"

​
margin
string

Amount of funds in open position money

Example:

"8316.74"

​
freeMargin
string

Free funds for trading

Example:

"619385.67"

​
funding
string

Funding that will be paid on next position stage change

Example:

"0"

​
unrealizedPnl
string

Unrealized profit and loss

Example:

"0.0019142920201966"

​
positionSide
enum<string>

Position side

Available options:
LONG,
SHORT,
BOTH
Example:

"LONG"

​
openDate
number

Date of position opening in Unix timestamp format

Example:

1651568067.789679

​
modifyDate
number

Date of position modifying (current event) in Unix timestamp format

Example:

1651568067.789679

​
liquidationPrice
string | null

Liquidation price according to current state of position

Example:

null

​
liquidationState
enum<string> | null

State of liquidation

Available options:
margin_call,
liquidation
Example:

null

​
tpsl
object

Take profit and stop loss configuration

​
unrealizedFunding
string

Funding that will be paid on next position stage change

Example:

"0.0019142920201966"