> For the complete documentation index, see [llms.txt](https://docs.dapplooker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapplooker.com/products/api-endpoints/wallet-intelligence/wallet-portfolio.md).

# Wallet Portfolio

Returns the portfolio overview of any EVM or Solana wallet — total value across all positions, distribution by chain, distribution by position type (wallet tokens, deposited, borrowed, locked, staked)

## Endpoint

```
GET https://api.dapplooker.com/v1/wallet-portfolio/{address}
```

#### **Path Parameters**

| Parameter | Type   | Mandatory | Description                           |
| --------- | ------ | --------- | ------------------------------------- |
| `address` | string | Yes       | EVM (`0x…`) or Solana wallet address. |

#### **Query Parameters**

| Parameter name      | Type    | Mandatory | Description                                                                                                                                                               |
| ------------------- | ------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api_key`           | string  | Yes       | Your unique DappLooker API key used for authentication. Optional if querying via x402                                                                                     |
| `currency`          | string  | No        | Currency for all price values. Default: `usd`. Supported: `usd`, `eth`, `btc`, `eur`, `gbp`, `jpy`, `cad`, `aud`, `inr`, `cny`, `krw`, `chf`, `rub`, `nzd`, `try`, `zar`. |
| `filter[positions]` | string  | No        | Scope of positions to include in the aggregation. Values: `only_simple` (default), `only_complex`, `no_filter`.                                                           |
| `sync`              | boolean | No        | Trigger a live blockchain sync before responding. Default: `false`. When `true`, allow up to 30 seconds for a response.                                                   |

#### **Example Request**

```bash
# Full portfolio (tokens + DeFi positions)
curl --location 'https://api.dapplooker.com/v1/wallet-portfolio/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?api_key=<API_KEY>&filter[positions]=no_filter&currency=usd'

# Token balances only
curl --location 'https://api.dapplooker.com/v1/wallet-portfolio/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?api_key=<API_KEY>&filter[positions]=only_simple'

# Force live sync
curl --location 'https://api.dapplooker.com/v1/wallet-portfolio/0x42b9df65b219b3dd36ff330a4dd8f327a6ada990?api_key=<API_KEY>&sync=true'
```

#### **Example Response**

```json
{
  "success": true,
  "data": {
    "wallet_address": "0x42b9df65b219b3dd36ff330a4dd8f327a6ada990",
    "currency": "usd",
    "total": {
      "positions": 2017.49
    },
    "changes": {
      "absolute_1d": 102.03,
      "percent_1d": 5.33
    },
    "positions_distribution_by_type": {
      "wallet": 1864.77,
      "deposited": 78.04,
      "borrowed": 0.98,
      "locked": 5.78,
      "staked": 66.13
    },
    "positions_distribution_by_chain": {
      "ethereum": 1214.01,
      "optimism": 573.03,
      "arbitrum": 458.36,
      "polygon": 64.31,
      "base": 55.02,
      "xdai": 113.17,
      "fantom": 84.59,
      "avalanche": 17.13,
      "binance-smart-chain": 5.56,
      "celo": 31.29,
      "linea": 8.26,
      "aurora": 72.01,
      "zksync-era": 9.45
    }
  }
}
```

#### **Response Fields Explanation**

* `wallet_address` *(string)*: The queried wallet address.
* `currency` *(string)*: Currency used for all value fields in the response.
* `total.positions` *(float)*: Total portfolio value across all positions in the selected currency.
* `changes.absolute_1d` *(float)*: Absolute portfolio value change over the last 24 hours.
* `changes.percent_1d` *(float)*: Portfolio value change as a percentage over the last 24 hours.
* `positions_distribution_by_type` *(object)*: Portfolio value broken down by position category.
  * `wallet` *(float)*: Value of tokens held directly in the wallet.
  * `deposited` *(float)*: Value of assets deposited into DeFi protocols (lending pools, vaults, etc.).
  * `borrowed` *(float)*: Value of assets borrowed against deposited collateral.
  * `locked` *(float)*: Value of locked or vesting positions.
  * `staked` *(float)*: Value of staked assets.
* `positions_distribution_by_chain` *(object)*: Key-value map of chain ID → USD value. Covers every chain where the wallet holds an active position.