---
updatedAt: 2026-08-26T07:21:33.000Z
agentTools:
  projectIndex: https://docs.blockdaemon.com/llms.txt
---

# Get Wallet Position

Retrieves comprehensive information about a wallet’s positions across various DEX protocols. It aggregates key data—including protocol details, liquidity positions, token balances (with USD valuations), and pool metrics (such as reserve amounts and share of pool)—to provide a clear snapshot of the wallet’s DeFi exposure. 

> 💡 
**Compute Unit Value:** `170` (Fixed)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "contact": {
      "name": "Blockdaemon",
      "email": "info@blockdaemon.com"
    },
    "description": "The Blockdaemon DeFi API provides a single interface to a multitude of DeFi projects and blockchains",
    "title": "Blockdaemon DeFi API",
    "version": "1.0.0",
    "x-logo": {
      "altText": "Blockdaemon logo",
      "backgroundColor": "#fafafa",
      "url": "https://storage.googleapis.com/blockdaemon-app-static-images/marketing/PNG/dark-logo.png"
    }
  },
  "externalDocs": {
    "description": "Blockdaemon DeFi documentation",
    "url": "http://www.blockdaemon.com/api/defi"
  },
  "servers": [
    {
      "url": "https://svc.blockdaemon.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "`X-API-Key: <Token>` header must be set to authenticate API requests.You can create tokens in the \"Configure\" tab of your API access area at https://app.blockdaemon.com."
      }
    }
  },
  "tags": [
    {
      "name": "dex",
      "description": "API endpoints for operations related to decentralized exchange"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "paths": {
    "/defi/v1/dex/getwalletposition": {
      "get": {
        "tags": [
          "dex"
        ],
        "summary": "Get Wallet Position",
        "description": "Retrieves comprehensive information about a wallet’s positions across various DEX protocols. It aggregates key data—including protocol details, liquidity positions, token balances (with USD valuations), and pool metrics (such as reserve amounts and share of pool)—to provide a clear snapshot of the wallet’s DeFi exposure. \n\n> 💡 \n**Compute Unit Value:** `170` (Fixed)",
        "operationId": "dexGetwalletposition",
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Public address of the user.",
              "example": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402"
            },
            "description": "Public address of the user."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "integer"
                    },
                    "msg": {
                      "type": "string"
                    },
                    "data": {
                      "type": "object"
                    }
                  },
                  "example": {
                    "status": 200,
                    "msg": "success",
                    "data": [
                      {
                        "protocol_name": "Uniswap v2",
                        "protocol_id": "uniswap-v2",
                        "protocol_url": "https://app.uniswap.org/pools/v2",
                        "account_data": {},
                        "total_projected_earnings_usd": {
                          "daily": null,
                          "weekly": null,
                          "monthly": null,
                          "yearly": null
                        },
                        "position": {
                          "label": "liquidity",
                          "tokens": [
                            {
                              "token_type": "supplied",
                              "name": "Ocean Token",
                              "symbol": "OCEAN",
                              "contract_address": "0x7afebbb46fdb47ed17b22ed075cde2447694fb9e",
                              "decimals": "18",
                              "balance": "1.6081842334083308815902940220990230780999386e+23",
                              "usd_price": 0.3606446348915287
                            },
                            {
                              "token_type": "supplied",
                              "name": "Wrapped Ether",
                              "symbol": "WETH",
                              "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                              "decimals": "18",
                              "balance": "164740674239285818005.81690560285198009496",
                              "usd_price": 3711.793202043769
                            },
                            {
                              "token_type": "defi-token",
                              "name": "Uniswap V2",
                              "symbol": "UNI-V2",
                              "contract_address": "0xf063806d07fe742b031a543145fb46d1bc670fe8",
                              "decimals": "18",
                              "balance": "4814188687222267334774",
                              "usd_price": null
                            }
                          ],
                          "address": "0xf063806d07fe742b031a543145fb46d1bc670fe8",
                          "balance_usd": 669481.6163110741,
                          "total_unclaimed_usd_value": null,
                          "position_details": {
                            "reserve0": "160818.42334083308815902940220990230780999386",
                            "reserve1": "164.74067423928581800581690560285198009496",
                            "factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f",
                            "pair": "0xf063806d07fe742b031a543145fb46d1bc670fe8",
                            "share_of_pool": 26.97033761448816
                          }
                        }
                      },
                      {
                        "protocol_name": "Uniswap v3",
                        "protocol_id": "uniswap-v3",
                        "protocol_url": "https://app.uniswap.org",
                        "account_data": {},
                        "total_projected_earnings_usd": {
                          "daily": null,
                          "weekly": null,
                          "monthly": null,
                          "yearly": null
                        },
                        "position": {
                          "label": "Liquidity",
                          "balance_usd": 92.79077171190019,
                          "total_unclaimed_usd_value": 0,
                          "tokens": [
                            {
                              "token_type": "supplied",
                              "name": "USD Coin",
                              "symbol": "USDC",
                              "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                              "decimals": "6",
                              "balance": "0",
                              "usd_price": 0.9984084045632092
                            },
                            {
                              "token_type": "supplied",
                              "name": "Wrapped Ether",
                              "symbol": "WETH",
                              "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                              "decimals": "18",
                              "balance": "24998906636503404",
                              "usd_price": 3711.793202043769
                            },
                            {
                              "token_type": "reward",
                              "name": "USD Coin",
                              "symbol": "USDC",
                              "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                              "decimals": "6",
                              "balance": "0",
                              "usd_price": 0.9984084045632092
                            },
                            {
                              "token_type": "reward",
                              "name": "Wrapped Ether",
                              "symbol": "WETH",
                              "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                              "decimals": "18",
                              "balance": "0",
                              "usd_price": 3711.793202043769
                            }
                          ]
                        }
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "x-bd-cu": "170",
        "x-bd-cu-type": "fixed",
        "x-internal": false
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```