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

# Get user's vaults positions

> Retrieves detailed information about a specific user's positions across all Mellow Protocol vaults.
This includes their liquidity provisions, earned profits, and current holdings as a Liquidity Provider.




## OpenAPI

````yaml GET /v1/users/{user_address}
openapi: 3.0.0
info:
  title: Mellow Protocol API
  description: >
    API for Mellow Protocol's permissionless vaults and Liquid Restaking Token
    (LRT) system. 

    Mellow offers a series of vault smart contracts tailored to different risk
    profiles, managed by LRT curators.

    The system allows permissionless creation of modular LRTs and active
    liquidity management.
  version: 1.0.0
servers:
  - url: https://points.mellow.finance
    description: Production server
security: []
paths:
  /v1/users/{user_address}:
    get:
      summary: Get user's vaults positions
      description: >
        Retrieves detailed information about a specific user's positions across
        all Mellow Protocol vaults.

        This includes their liquidity provisions, earned profits, and current
        holdings as a Liquidity Provider.
      operationId: getUserPositions
      parameters:
        - name: user_address
          in: path
          required: true
          description: Ethereum address of the user (must be a valid Ethereum address)
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{40}$
          example: '0x1234567890123456789012345678901234567890'
      responses:
        '200':
          description: Successful response containing user's positions across all vaults
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserPosition'
        '500':
          description: Internal server error
          content:
            text/plain:
              schema:
                type: string
                description: Internal server error message
                example: Internal server error
components:
  schemas:
    UserPosition:
      type: object
      required:
        - chain_id
        - user_address
        - user_mellow_points
        - user_symbiotic_points
        - user_referal_points
        - user_vault_balance
        - timestamp
        - vault_address
      properties:
        chain_id:
          type: integer
          description: The blockchain network ID where the vault is deployed
        user_address:
          type: string
          description: The Ethereum address of the user
        user_mellow_points:
          type: string
          description: Points earned by the user in the Mellow protocol
        user_symbiotic_points:
          type: string
          description: Points earned by the user in the Symbiotic protocol
        user_referal_points:
          type: string
          description: Points earned by the user through referrals
        user_vault_balance:
          type: number
          description: User's balance in the vault in smallest units
        timestamp:
          type: integer
          description: Unix timestamp of when the data was last updated
        vault_address:
          type: string
          description: The smart contract address of the vault
      example:
        chain_id: 1
        user_address: '0x7F43fDe12A40dE708d908Fb3b9BFB8540d9Ce444'
        user_mellow_points: '0'
        user_symbiotic_points: '0'
        user_referal_points: '0'
        user_vault_balance: 10000000000000
        timestamp: 1737151835
        vault_address: '0x7F43fDe12A40dE708d908Fb3b9BFB8540d9Ce444'

````