> ## 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 Wallet DeFi Positions

> Retrieve DeFi positions across multiple protocols for a wallet address.



## OpenAPI

````yaml get /2/wallet/defi-positions
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:
  /2/wallet/defi-positions:
    get:
      tags:
        - V2 - Wallet
      summary: Get Wallet Defi-Positions
      parameters:
        - schema:
            anyOf:
              - type: string
                minLength: 32
                maxLength: 44
              - type: string
                pattern: ^0x[a-fA-F0-9]{40}$
            description: Wallet address (EVM or Solana)
          required: true
          description: Wallet address (EVM or Solana)
          name: wallet
          in: query
        - schema:
            type: string
            description: Chain ID to fetch positions from (e.g., "solana:solana", "evm:1")
          required: false
          description: Chain ID to fetch positions from (e.g., "solana:solana", "evm:1")
          name: chainIds
          in: query
      responses:
        '200':
          description: Wallet Defi-Positions response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        protocol:
                          type: object
                          properties:
                            name:
                              type: string
                            id:
                              type: string
                            logo:
                              type: string
                            url:
                              type: string
                          required:
                            - name
                            - id
                            - logo
                            - url
                        positions:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                              name:
                                type: string
                              chain_id:
                                type: string
                              contract:
                                type: string
                              created_at:
                                type: string
                                nullable: true
                              tokens:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    symbol:
                                      type: string
                                    contract:
                                      type: string
                                    amount:
                                      type: string
                                    amountRaw:
                                      type: string
                                    decimals:
                                      type: string
                                    amount_usd:
                                      type: string
                                    logo:
                                      type: string
                                      nullable: true
                                    price_usd:
                                      type: string
                                      nullable: true
                                  required:
                                    - name
                                    - symbol
                                    - contract
                                    - amount
                                    - amountRaw
                                    - decimals
                                    - amount_usd
                                    - logo
                                    - price_usd
                              rewards:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    name:
                                      type: string
                                    symbol:
                                      type: string
                                    contract:
                                      type: string
                                    amount:
                                      type: string
                                    amountRaw:
                                      type: string
                                    decimals:
                                      type: string
                                    amount_usd:
                                      type: string
                                    price_usd:
                                      type: string
                                  required:
                                    - name
                                    - symbol
                                    - contract
                                    - amount
                                    - amountRaw
                                    - decimals
                                    - amount_usd
                                    - price_usd
                              extra:
                                type: object
                                properties:
                                  lp_token_amount:
                                    type: string
                                  position_staked_amount:
                                    type: string
                                  factory:
                                    type: string
                                  share_of_pool:
                                    type: string
                                  type:
                                    type: string
                                    enum:
                                      - supply
                                      - borrow
                                  health_factor:
                                    type: number
                                  reserve0:
                                    type: string
                                  reserve1:
                                    type: string
                                  reserve_usd:
                                    type: number
                            required:
                              - type
                              - name
                              - chain_id
                              - contract
                              - created_at
                              - tokens
                      required:
                        - protocol
                        - positions
                  wallets:
                    type: array
                    items:
                      type: string
                required:
                  - data
                  - wallets

````