v1

latestOpenAPI 3.1.0UNLICENSED2026-07-26216788.0 KB
Portfolio

GetPortfolio

Returns an aggregated portfolio snapshot for one wallet: margin, PnL, volume, fee, and equity totals, plus the wallet's currently open positions and open orders.

NOTE: positions and orders are open-only — closed positions and terminal-status orders are folded into the aggregate totals but are not listed individually here. All totals are recomputed fresh on every request (not cached), so this endpoint is heavier than a single-position or single-order lookup.

post/portfolio.v1.PortfolioService/GetPortfolio

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol. If omitted, use 1.

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

ownerstring required

Wallet address to compute a portfolio for.

Response

Success

Example response

{
  "portfolio": {
    "timestamp": "2023-01-15T01:30:15.01Z",
    "positions": [
      {
        "timestamp": "2023-01-15T01:30:15.01Z",
        "associatedOrders": [
          {
            "timestamp": "2023-01-15T01:30:15.01Z"
          }
        ]
      }
    ],
    "orders": [
      {
        "timestamp": "2023-01-15T01:30:15.01Z"
      }
    ]
  }
}