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",
      "notionalValue": "3739.020468"
    },
    {
      "market": "BTC-USD",
      "value": "-65000.272138",
      "quantity": "-1.0",
      "funding": "920.49110924999998",
      "realizedPnl": "1.5",
      "unrealizedPnl": "400.25166999999965",
      "liquidationPrice": "61033.135417",
      "type": "SHORT",
      "notionalValue": "-65400.523808"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rails.xyz/llms.txt

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

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
market
string

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

Response

​
positions
object[]
required

List of positions for the account.