Skip to main content
GET
Get open perpetual and futures positions
10 credits per request

  • Connected exchange positions with leverage, prices, unrealized P&L and funding where available
  • portfolioId: Owned exchange or parent from GET /portfolio/list. Omit for all owned exchanges.
  • Uses existing exchange connectors and CoinStats ticker-based P&L. Missing fields and unavailable prices are null. Options are excluded.
  • Funding since opening is positive when received and negative when paid, separate from unrealized P&L. It is not a rate or payment history.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

portfolioId
string

Owned exchange or parent portfolio from GET /portfolio/list. Omit for all owned exchanges.

Response

positions
object[]
required
updatedAt
number
required

Retrieval time in Unix milliseconds.