GET
/
api
/
positions

Overview

The Positions endpoint returns all active trading positions for a specific Ethereum address, including position details, orders, triggers, and associated fees.

Important Notes

  • Only returns currently active positions
  • Includes both long and short positions
  • Provides detailed fee information
  • Shows all associated orders and triggers

Parameters

address
string
required

Ethereum address of the user (0x format)

Response Fields

Position Object

posIds
array

Array of unique position identifiers

positions
array

Array of position objects containing:

  • posId: Position identifier
  • size: Position size
  • margin: Margin amount
  • isLong: Position direction
  • entryPrice: Entry price
  • leverage: Position leverage
orders
array

Array of associated orders

triggers
array

Array of stop-loss and take-profit triggers

paidFees
array

Array of already paid fees

accruedFees
array

Array of accumulated but unpaid fees

Example Usage

Query Parameters

address
string
required

Ethereum address of the user

Response

200 - application/json
posIds
string[]

Array of position IDs

positions
object[]

Array of position details

orders
object[]

Array of order objects

triggers
object[]

Array of trigger objects

paidFees
object[]

Array of paid fees objects

accruedFees
object[]

Array of accrued fees objects