HyperPaxeer NetworkPaxeer Network
API Reference

Get perps positions

GET
/api/v1/portfolio/{address}/perps/positions

Returns perpetuals positions for a user. Can filter by status and paginate. Each position includes market info, entry/current price, leverage, and PnL.

Path Parameters

address*string

Wallet address (with or without 0x prefix, case-insensitive)

Match^0x[a-fA-F0-9]{40}$

Query Parameters

status?string

Filter by position status

Value in"open" | "closed" | "liquidated"
limit?integer

Maximum results (max 100)

Default50
Rangevalue <= 100
offset?integer

Pagination offset

Default0

Response Body

application/json

text/plain

curl -X GET "https://us-east-1.user-stats.sidiora.exchange/api/v1/portfolio/0xf263aB36de550bDa08b52d43eB253b3C0387e2bc/perps/positions"
[
  {
    "position_id": "string",
    "user_address": "string",
    "market_id": 0,
    "market_name": "string",
    "market_symbol": "string",
    "is_long": true,
    "size_usd": "string",
    "leverage": "string",
    "entry_price": "string",
    "current_price": "string",
    "collateral_amount": "string",
    "collateral_usd": "string",
    "unrealized_pnl": "string",
    "realized_pnl": "string",
    "status": "open",
    "opened_at": "string",
    "closed_at": "string",
    "open_tx_hash": "string"
  }
]
"string"

Get perps portfolio summary GET

Returns the complete perpetuals portfolio for a user including: - Vault status and address - All open positions with unrealized PnL - Total collateral, unrealized/realized PnL - Aggregated user stats (position counts, trade counts, orders)

Get perps trade history GET

Returns perpetuals trade history for a user with pagination.