Endpoints
Get User Positions
Retrieve all active positions for a user
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
Ethereum address of the user (0x format)
Response Fields
Position Object
Array of unique position identifiers
Array of position objects containing:
posId
: Position identifiersize
: Position sizemargin
: Margin amountisLong
: Position directionentryPrice
: Entry priceleverage
: Position leverage
Array of associated orders
Array of stop-loss and take-profit triggers
Array of already paid fees
Array of accumulated but unpaid fees
Example Usage
Query Parameters
Ethereum address of the user