Skip to main content
GET
/
api
/
v1
/
positions
Get Account Positions
curl --request GET \
  --url https://user-account.trade.rails.xyz/api/v1/positions \
  --header 'Authorization: Bearer <token>'
{
  "positions": [
    {
      "market": "ETH-USD",
      "value": "3772.272138",
      "quantity": "1.0",
      "funding": "92.49110924999998",
      "realizedPnl": "0.1",
      "unrealizedPnl": "-33.25166999999965",
      "liquidationPrice": "3500.652918",
      "type": "LONG"
    },
    {
      "market": "BTC-USD",
      "value": "65000.272138",
      "quantity": "1.0",
      "funding": "920.49110924999998",
      "realizedPnl": "1.5",
      "unrealizedPnl": "400.25166999999965",
      "liquidationPrice": "61033.135417",
      "type": "SHORT"
    }
  ]
}
Response fields are calculated as follows:unrealizedPnl = (indexPrice − avgEntryPrice) × quantityliquidationPrice formula can be found hereIf you want to determine the average entry price for a position, simply divide the value by the quantity—both fields are included in the response.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
market
string

Example value: ETH-USD. To get all supported markets, call /api/v1/markets endpoint. Omit this parameter to get results across all markets.

Response

200 - application/json
​
positions
object[]
⌘I