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

# Get Crypto Holdings



## OpenAPI

````yaml get /1/wallet/portfolio
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, trendings, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /1/wallet/portfolio:
    get:
      tags:
        - V1 - Wallet
      summary: Get wallet portfolio
      parameters:
        - schema:
            type: string
            description: Wallet address
          required: false
          description: Wallet address
          name: wallet
          in: query
        - schema:
            type: string
            description: Comma-separated wallet addresses
          required: false
          description: Comma-separated wallet addresses
          name: wallets
          in: query
        - schema:
            type: string
            description: Portfolio ID
          required: false
          description: Portfolio ID
          name: portfolio
          in: query
        - schema:
            type: string
            description: Comma-separated blockchain IDs
          required: false
          description: Comma-separated blockchain IDs
          name: blockchains
          in: query
        - schema:
            type: string
            description: Filter by specific asset
          required: false
          description: Filter by specific asset
          name: asset
          in: query
        - schema:
            type: string
            description: Start date
          required: false
          description: Start date
          name: from
          in: query
        - schema:
            type: string
            description: End date
          required: false
          description: End date
          name: to
          in: query
        - schema:
            type: string
            description: Portfolio display settings
          required: false
          description: Portfolio display settings
          name: portfolio_settings
          in: query
        - schema:
            type: string
            description: Include unlisted assets
          required: false
          description: Include unlisted assets
          name: unlistedAssets
          in: query
        - schema:
            type: string
            description: Time period
          required: false
          description: Time period
          name: period
          in: query
        - schema:
            type: string
            description: Data accuracy level
          required: false
          description: Data accuracy level
          name: accuracy
          in: query
        - schema:
            type: string
            description: Include testnet data
          required: false
          description: Include testnet data
          name: testnet
          in: query
        - schema:
            type: string
            description: Minimum liquidity threshold
          required: false
          description: Minimum liquidity threshold
          name: minliq
          in: query
        - schema:
            type: string
            description: Filter spam tokens
          required: false
          description: Filter spam tokens
          name: filterSpam
          in: query
        - schema:
            type: string
            description: Include PnL data
          required: false
          description: Include PnL data
          name: pnl
          in: query
      responses:
        '200':
          description: Wallet portfolio response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      total_wallet_balance:
                        type: number
                      wallets:
                        type: array
                        items:
                          type: string
                      assets:
                        type: array
                        items:
                          type: object
                          properties:
                            contracts_balances:
                              type: array
                              items:
                                type: object
                                properties:
                                  address:
                                    type: string
                                  balance:
                                    type: number
                                  balanceRaw:
                                    type: string
                                  chainId:
                                    type: string
                                  decimals:
                                    type: number
                                  tokenType:
                                    type: string
                                    nullable: true
                                    enum:
                                      - '2020'
                                      - '2022'
                                      - erc20
                                      - trc10
                                      - trc20
                                  security:
                                    type: object
                                    nullable: true
                                    properties:
                                      buyTax:
                                        type: string
                                        nullable: true
                                      sellTax:
                                        type: string
                                        nullable: true
                                      transferPausable:
                                        type: boolean
                                      top10Holders:
                                        type: string
                                      isBlacklisted:
                                        type: boolean
                                      noMintAuthority:
                                        type: boolean
                                      balanceMutable:
                                        type: boolean
                                      lowLiquidity:
                                        type: string
                                      burnRate:
                                        type: string
                                      liquidityBurnPercentage:
                                        type: number
                                      isHoneypot:
                                        type: boolean
                                      isNotOpenSource:
                                        type: boolean
                                      renounced:
                                        type: boolean
                                      locked:
                                        type: string
                                      isWhitelisted:
                                        type: boolean
                                      isMintable:
                                        type: boolean
                                      modifyableTax:
                                        type: boolean
                                      selfDestruct:
                                        type: boolean
                                      frozen:
                                        type: boolean
                                  lamports:
                                    type: string
                                    nullable: true
                                  tokenAccount:
                                    type: string
                                    nullable: true
                                required:
                                  - address
                                  - balance
                                  - balanceRaw
                                  - chainId
                                  - decimals
                            cross_chain_balances:
                              type: object
                              additionalProperties:
                                type: object
                                properties:
                                  balance:
                                    type: number
                                  balanceRaw:
                                    type: string
                                  chainId:
                                    type: string
                                  address:
                                    type: string
                                required:
                                  - balance
                                  - balanceRaw
                                  - chainId
                                  - address
                            price_change_24h:
                              type: number
                            estimated_balance:
                              type: number
                            price:
                              type: number
                            liquidity:
                              type: number
                            token_balance:
                              type: number
                            allocation:
                              type: number
                            asset:
                              type: object
                              properties:
                                id:
                                  type: number
                                  nullable: true
                                name:
                                  type: string
                                symbol:
                                  type: string
                                logo:
                                  type: string
                                  nullable: true
                                decimals:
                                  type: array
                                  items:
                                    type: string
                                    pattern: ^d+$
                                contracts:
                                  type: array
                                  items:
                                    type: string
                                blockchains:
                                  type: array
                                  items:
                                    type: string
                              required:
                                - id
                                - name
                                - symbol
                                - decimals
                                - contracts
                                - blockchains
                            wallets:
                              type: array
                              items:
                                type: string
                            realized_pnl:
                              type: number
                            unrealized_pnl:
                              type: number
                            price_bought:
                              type: number
                            total_invested:
                              type: number
                            min_buy_price:
                              type: number
                            max_buy_price:
                              type: number
                          required:
                            - contracts_balances
                            - cross_chain_balances
                            - price_change_24h
                            - estimated_balance
                            - price
                            - liquidity
                            - token_balance
                            - allocation
                            - asset
                            - wallets
                      win_rate:
                        type: number
                      tokens_distribution:
                        type: object
                        properties:
                          10x+:
                            type: number
                          4x - 10x:
                            type: number
                          2x - 4x:
                            type: number
                          10% - 2x:
                            type: number
                          '-10% - 10%':
                            type: number
                          '-50% - -10%':
                            type: number
                          '-100% - -50%':
                            type: number
                        required:
                          - 10x+
                          - 4x - 10x
                          - 2x - 4x
                          - 10% - 2x
                          - '-10% - 10%'
                          - '-50% - -10%'
                          - '-100% - -50%'
                      pnl_history:
                        type: object
                        properties:
                          1y:
                            type: array
                            items:
                              type: array
                              items:
                                anyOf:
                                  - type: string
                                    nullable: true
                                  - type: object
                                    properties:
                                      realized:
                                        type: number
                                      unrealized:
                                        type: number
                                    required:
                                      - realized
                                      - unrealized
                              minItems: 2
                              maxItems: 2
                          7d:
                            type: array
                            items:
                              type: array
                              items:
                                anyOf:
                                  - type: string
                                    nullable: true
                                  - type: object
                                    properties:
                                      realized:
                                        type: number
                                      unrealized:
                                        type: number
                                    required:
                                      - realized
                                      - unrealized
                              minItems: 2
                              maxItems: 2
                          24h:
                            type: array
                            items:
                              type: array
                              items:
                                anyOf:
                                  - type: string
                                    nullable: true
                                  - type: object
                                    properties:
                                      realized:
                                        type: number
                                      unrealized:
                                        type: number
                                    required:
                                      - realized
                                      - unrealized
                              minItems: 2
                              maxItems: 2
                          30d:
                            type: array
                            items:
                              type: array
                              items:
                                anyOf:
                                  - type: string
                                    nullable: true
                                  - type: object
                                    properties:
                                      realized:
                                        type: number
                                      unrealized:
                                        type: number
                                    required:
                                      - realized
                                      - unrealized
                              minItems: 2
                              maxItems: 2
                        required:
                          - 1y
                          - 7d
                          - 24h
                          - 30d
                      total_realized_pnl:
                        type: number
                      total_unrealized_pnl:
                        type: number
                      total_pnl_history:
                        type: object
                        properties:
                          24h:
                            type: object
                            properties:
                              realized:
                                type: number
                              unrealized:
                                type: number
                            required:
                              - realized
                              - unrealized
                          7d:
                            type: object
                            properties:
                              realized:
                                type: number
                              unrealized:
                                type: number
                            required:
                              - realized
                              - unrealized
                          30d:
                            type: object
                            properties:
                              realized:
                                type: number
                              unrealized:
                                type: number
                            required:
                              - realized
                              - unrealized
                          1y:
                            type: object
                            properties:
                              realized:
                                type: number
                              unrealized:
                                type: number
                            required:
                              - realized
                              - unrealized
                        required:
                          - 24h
                          - 7d
                          - 30d
                          - 1y
                      balances_length:
                        type: number
                    required:
                      - total_wallet_balance
                      - wallets
                      - assets
                      - balances_length
                  backfill_status:
                    type: string
                    enum:
                      - processed
                      - processing
                      - pending
                required:
                  - data

````