Skip to main content
GET
Get a position

Authorizations

Authorization
string
header
required

An API key from the account page, sent as Authorization: Bearer tapi_….

Path Parameters

symbol
string
required

A market symbol from GET /v1/markets, for example BTC or TSLA. Case-insensitive.

Response

The position.

object
string
required
Allowed value: "position"
market
string
required
direction
enum<string>
required
Available options:
long,
short
size
string
required

Always positive; direction gives the side.

value
string
required

size × price, in USD.

entry_price
string
required

The average price of the position.

price
string
required

The current mark price.

unrealized_pnl
string
required

Profit or loss if the position closed at price, in USD.

liquidation_price
string | null
required

The price at which the position would be liquidated. Positions are 1×, so it is far away.

funding_since_open
string
required

Funding paid (negative) or received (positive) since the position opened, in USD.

summary
string
required