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

# Portfolio List

> List all portfolios with filtering options

Lists all portfolios with various filtering options.

<ParamField query="userAddress" type="string">
  Filter portfolios by owner Ethereum address
</ParamField>

<ParamField query="portfolioId" type="string">
  Filter by portfolio ID
</ParamField>

<ParamField query="portfolioAddress" type="string">
  Filter by portfolio vault address
</ParamField>

<ParamField query="portfolioChainId" type="string">
  Filter by portfolio vault chain ID
</ParamField>

<ParamField query="isArchived" type="boolean">
  Filter for archived (`true`) or active (`false`) portfolios
</ParamField>

<ParamField query="hasAutomation" type="boolean">
  Filter for portfolios with automation enabled
</ParamField>

<ParamField query="limit" type="number" default="20">
  Number of results to return
</ParamField>

<ParamField query="offset" type="number" default="0">
  Pagination offset
</ParamField>

<ParamField query="sort" type="string" default="created_at">
  Sort field (options: `created_at`, `updated_at`, `name`)
</ParamField>

<ParamField query="order" type="string" default="desc">
  Sort order (options: `asc`, `desc`)
</ParamField>

<ParamField query="search" type="string">
  Text search term
</ParamField>

<ParamField query="chainId" type="string">
  Filter by chain ID
</ParamField>

<ParamField query="tag" type="string">
  Filter by portfolio tag
</ParamField>

<ParamField query="includeAssets" type="boolean" default="true">
  Include detailed asset data
</ParamField>

<ParamField query="realtime" type="boolean" default="false">
  Use real-time blockchain data instead of cached data
</ParamField>

<ParamField header="X-API-KEY" type="string" required>
  Your API key for authentication
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url '/v1/portfolios?userAddress=0xYourWalletAddress&limit=10&offset=0&sort=created_at&order=desc' \
    --header 'X-API-KEY: your_api_key_here'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `/v1/portfolios?userAddress=0xYourWalletAddress&limit=10&offset=0&sort=created_at&order=desc`,
    {
      method: "GET",
      headers: {
        "X-API-KEY": "your_api_key_here",
      },
    }
  );

  const portfolios = await response.json();
  console.log(`User has ${portfolios.data.pagination.total} portfolios`);
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "portfolios": [
        {
          "id": "port_abc123",
          "name": "70/30 ETH-USDC Portfolio",
          "description": "A simple portfolio with 70% ETH and 30% USDC allocation",
          "ownerAddress": "0xUserWalletAddress",
          "isPublic": false,
          "isArchived": false,
          "createdAt": "2023-05-21T12:34:56.789Z",
          "updatedAt": "2023-05-21T13:45:12.345Z",
          "tags": ["api-created"],
          "templateId": "tmpl_xyz789",
          "valueUsd": "1053.75",
          "vaults": [
            {
              "chainId": "8453",
              "address": "0xPortfolioVaultAddress",
              "assets": [
                {
                  "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                  "chainId": 8453,
                  "decimals": 18,
                  "symbol": "ETH",
                  "name": "Ethereum",
                  "logoURI": "https://assets.glider.fi/icons/eth.png",
                  "assetId": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE:8453",
                  "totalBalance": "0.5",
                  "baseTokenBalance": "0.5",
                  "priceUSD": "1500",
                  "amount": "0.5",
                  "rawAmount": "500000000000000000"
                },
                {
                  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
                  "chainId": 8453,
                  "decimals": 6,
                  "symbol": "USDC",
                  "name": "USD Coin",
                  "logoURI": "https://assets.glider.fi/icons/usdc.png",
                  "assetId": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913:8453",
                  "totalBalance": "300",
                  "baseTokenBalance": "300",
                  "priceUSD": "1",
                  "amount": "300",
                  "rawAmount": "300000000"
                }
              ]
            }
          ]
        }
      ],
      "pagination": {
        "total": 1,
        "limit": 10,
        "offset": 0,
        "hasMore": false
      }
    },
    "correlationId": "corr_abc123",
    "requestId": "req_xyz789",
    "timestamp": "2023-05-21T12:34:56.789Z"
  }
  ```
</ResponseExample>