> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agg.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Get balances

> Returns per-chain token balances and per-venue position balances for the authenticated user.



## OpenAPI

````yaml /openapi/openapi.json get /execution/balances
openapi: 3.0.2
info:
  title: AGG API
  version: 1.0.0
  description: >-
    Prediction market aggregator REST API — authentication, users, venue events,
    venue markets, orderbooks, charts, and execution workflows.
servers:
  - url: https://api.agg.market
    description: Production
  - url: https://api.staging.agg.market
    description: Staging
security: []
paths:
  /execution/balances:
    get:
      tags:
        - Users
      summary: Get balances
      description: >-
        Returns per-chain token balances and per-venue position balances for the
        authenticated user.
      operationId: getManagedBalances
      parameters:
        - name: mode
          in: query
          required: false
          schema:
            type: string
            enum:
              - live
              - paper
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                required:
                  - cash
                  - positions
                properties:
                  cash:
                    type: array
                    items:
                      type: object
                      required:
                        - tokenSymbol
                        - totalRaw
                        - decimals
                        - chains
                      properties:
                        tokenSymbol:
                          type: string
                        totalRaw:
                          type: string
                        availableRaw:
                          type: string
                        reservedRaw:
                          type: string
                        decimals:
                          type: number
                        chains:
                          type: array
                          items:
                            type: object
                            required:
                              - chainId
                              - tokenAddress
                              - balanceRaw
                              - decimals
                              - lastSyncedAt
                            properties:
                              chainId:
                                type: number
                              tokenAddress:
                                type: string
                              balanceRaw:
                                type: string
                              heldRaw:
                                type: string
                              availableRaw:
                                type: string
                              decimals:
                                type: number
                              lastSyncedAt:
                                type: string
                              tokenSymbol:
                                type: string
                  positions:
                    type: array
                    items:
                      type: object
                      required:
                        - venue
                        - balance
                        - costBasis
                        - unrealizedPnl
                        - realizedPnl
                        - priceSource
                        - bookQuality
                      properties:
                        venue:
                          type: string
                          enum:
                            - kalshi
                            - polymarket
                            - limitless
                            - opinion
                            - predict
                            - probable
                            - myriad
                            - hyperliquid
                        balance:
                          type: number
                        costBasis:
                          type: number
                        unrealizedPnl:
                          type: number
                        realizedPnl:
                          type: number
                        priceSource:
                          type: string
                          enum:
                            - orderbook
                            - cached
                            - entry
                            - settled
                        bookQuality:
                          type: string
                          enum:
                            - healthy
                            - bid_only
                            - ask_only
                            - endpoint_stub
                            - wide_spread
                            - crossed
                            - empty
                        migrationPending:
                          type: boolean
                  venueCash:
                    type: array
                    items:
                      type: object
                      required:
                        - venue
                        - balanceCents
                        - updatedAt
                      properties:
                        venue:
                          type: string
                          enum:
                            - kalshi
                            - polymarket
                            - limitless
                            - opinion
                            - predict
                            - probable
                            - myriad
                            - hyperliquid
                        balanceCents:
                          type: integer
                        portfolioValueCents:
                          type: integer
                        updatedAt:
                          type: string
        '401':
          description: '401'
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '403':
          description: '403'
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
      security:
        - appId: []
          bearerAuth: []
components:
  securitySchemes:
    appId:
      type: apiKey
      in: header
      name: x-app-id
      description: Your application ID. Required for all app-tier and user-tier routes.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT access token returned by POST /auth/verify. Required for user-tier
        routes.

````