> ## Documentation Index > Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt > Use this file to discover all available pages before exploring further. # Consistent perp + spot portfolio > Perp positions and spot balances from one consistent node state (the right view for unified and portfolio-margin accounts, where spot collateral backs perps): one row per core-exchange position (`kind` perp; with `all_dexes=true` the positions of every perp dex, HIP-3 included, as hyperdash.com loads them) and per balance (`kind` spot). meta: core-exchange perp account value, withdrawable, maintenance margin, the account abstraction, and `equity`, `spot_value`, `staked_value` as on GET /v1/accounts/{address} (equity over every perp dex, spot at mid and staked HYPE, as hyperdash.com shows it). Pricing: flat + node reads. Scope: `accounts:read`. ## OpenAPI ````yaml /data-api/openapi.json get /v1/accounts/{address}/portfolio openapi: 3.1.0 info: title: Hyperdash Data API version: v1 description: >- Hyperliquid data from Hyperdash's own nodes. Every response reports the credits it cost. servers: - url: https://data.hyperdash.com security: [] tags: - name: Accounts - name: Async jobs - name: Builders - name: Cohorts - name: HIP-3 DEXs - name: Leaderboards - name: Lending - name: Liquidations - name: Markets - name: Network - name: Outcomes - name: Positions - name: Snapshots - name: Spot - name: Staking - name: Traders paths: /v1/accounts/{address}/portfolio: get: tags: - Accounts summary: Consistent perp + spot portfolio description: >- Perp positions and spot balances from one consistent node state (the right view for unified and portfolio-margin accounts, where spot collateral backs perps): one row per core-exchange position (`kind` perp; with `all_dexes=true` the positions of every perp dex, HIP-3 included, as hyperdash.com loads them) and per balance (`kind` spot). meta: core-exchange perp account value, withdrawable, maintenance margin, the account abstraction, and `equity`, `spot_value`, `staked_value` as on GET /v1/accounts/{address} (equity over every perp dex, spot at mid and staked HYPE, as hyperdash.com shows it). Pricing: flat + node reads. Scope: `accounts:read`. operationId: getAccountPortfolio parameters: - name: address in: path required: true description: Wallet, 0x + 40 hex. schema: type: string pattern: ^0x[0-9a-fA-F]{40}$ - name: all_dexes in: query required: false description: >- true: position rows for every perp dex (core first), from the same read; default: the core exchange only. schema: type: string default: 'false' enum: - 'false' - 'true' - name: X-Max-Credits in: header required: false description: Refuse (free) if the request could cost more. schema: type: integer - name: X-Credit-Price-Version in: header required: false description: Expected price version; 409 price_changed if it differs. schema: type: integer responses: '200': description: OK headers: X-Credits-Charged: schema: type: integer X-Credit-Price-Version: schema: type: integer X-Request-Id: schema: type: string content: application/json: schema: type: object required: - data - has_more - next_cursor - meta properties: data: type: array items: type: object properties: kind: type: string description: perp or spot dex: type: - string - 'null' description: >- Perp dex of the position ("native" = core exchange); null for spot coin: type: string description: Market (perp) or token (spot) size: type: string description: >- Signed position size (perp) or total balance (spot) (decimal string; may carry extra trailing zeros) entry: type: - string - 'null' description: >- Entry price (perp) or entry notional (spot) (decimal string; may carry extra trailing zeros) value: type: - string - 'null' description: >- Position value (perp, USD) (decimal string; may carry extra trailing zeros) unrealized_pnl: type: - string - 'null' description: >- Unrealized PnL (perp) (decimal string; may carry extra trailing zeros) margin_used: type: - string - 'null' description: >- Margin used (perp) (decimal string; may carry extra trailing zeros) liquidation_px: type: - string - 'null' description: >- Liquidation price (perp) (decimal string; may carry extra trailing zeros) leverage: type: - integer - 'null' description: Leverage (perp) hold: type: - string - 'null' description: >- Held in open orders (spot) (decimal string; may carry extra trailing zeros) has_more: type: boolean next_cursor: type: - string - 'null' meta: type: object '400': description: Invalid parameter content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '401': description: Invalid, expired or revoked key content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '403': description: Scope, plan, history or credit limit content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '409': description: Price version changed content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '429': description: Rate limited (Retry-After) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' '503': description: Backend at capacity (Retry-After) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' security: - bearer: [] x-codeSamples: - lang: curl source: >- curl -H 'Authorization: Bearer $HD_KEY' 'https://data.hyperdash.com/v1/accounts/0x…/portfolio' components: schemas: Problem: type: object required: - type - title - status - code - request_id properties: type: type: string title: type: string status: type: integer code: type: string detail: type: string hint: type: string request_id: type: string securitySchemes: bearer: type: http scheme: bearer description: hdk_sk_live_v1_… or hdk_sk_test_v1_… ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.