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

# Get erc20 portfolio of a wallet



## OpenAPI

````yaml /openapi.json get /api/v1/evm/portfolio/{chainId}
openapi: 3.0.0
info:
  title: Mr Monei API Gateway
  description: External API for partners using API Key authentication
  version: '1.0'
  contact: {}
servers:
  - url: https://api.dev.monei.cc
    description: Dev Server
  - url: https://api.monei.cc
    description: Live Server
security: []
tags: []
paths:
  /api/v1/evm/portfolio/{chainId}:
    get:
      tags:
        - EVM Wallet
      summary: Get erc20 portfolio of a wallet
      operationId: EvmController_getPortfolio
      parameters:
        - name: chainId
          required: true
          in: path
          schema:
            type: number
      responses:
        default:
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserEvmPortfolioResponseDto'
      security:
        - bearer: []
        - api-key: []
components:
  schemas:
    UserEvmPortfolioResponseDto:
      type: object
      properties:
        statusCode:
          type: number
        message:
          type: string
        data:
          $ref: '#/components/schemas/UserEvmPortfolioDto'
        errors:
          type: object
      required:
        - statusCode
        - message
        - data
        - errors
    UserEvmPortfolioDto:
      type: object
      properties:
        userId:
          type: string
          example: usr_01J84P9RFGZBPX9RZV7N9M4E4B
          description: Unique identifier of the user.
        walletAddress:
          type: string
          example: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
          description: EVM wallet address of the user.
        network:
          type: string
          example: ethereum
          description: Network the wallet belongs to.
        totalPortfolioValueUSD:
          type: string
          example: '45990.34'
          description: >-
            Total portfolio value in USD, including all tokens and native
            assets.
        nativeToken:
          description: Details of the native token (e.g., ETH, BNB, MATIC).
          allOf:
            - $ref: '#/components/schemas/UserTokenBalanceDto'
        tokens:
          description: List of ERC-20 or native-like tokens in the user’s wallet.
          type: array
          items:
            $ref: '#/components/schemas/UserTokenBalanceDto'
        updatedAt:
          type: string
          example: '2025-10-04T12:45:00Z'
          description: Timestamp of when the portfolio was last updated.
      required:
        - userId
        - walletAddress
        - network
        - totalPortfolioValueUSD
        - nativeToken
        - tokens
        - updatedAt
    UserTokenBalanceDto:
      type: object
      properties:
        contractAddress:
          type: string
          example: '0x1234567890abcdef1234567890abcdef12345678'
          description: >-
            Contract address of the token. For native tokens, this may be
            omitted.
        name:
          type: string
          example: Ethereum
          description: Full name of the token.
        symbol:
          type: string
          example: ETH
          description: Token symbol (e.g., ETH, USDC).
        decimals:
          type: number
          example: 18
          description: Number of decimals used by the token.
        logoUrl:
          type: string
          example: https://assets.coingecko.com/coins/images/279/large/ethereum.png
          description: URL to the token logo (if available).
        type:
          type: string
          example: token
          enum:
            - native
            - token
          description: Specifies if the asset is a native coin or an ERC-20 token.
        balance:
          type: string
          example: '1.2543'
          description: Human-readable balance of the token.
        balanceUSD:
          type: string
          example: '3200.54'
          description: Token balance value in USD.
        priceUSD:
          type: string
          example: '2550.23'
          description: Current price of the token in USD.
        rawBalance:
          type: string
          example: '1254300000000000000'
          description: Raw balance in the smallest unit (e.g., wei for ETH).
        network:
          type: string
          example: ethereum
          description: Network name the token belongs to.
      required:
        - contractAddress
        - name
        - symbol
        - decimals
        - type
        - balance
        - balanceUSD
        - priceUSD
        - rawBalance
        - network
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-KEY

````