GET
/
v1
/
portfolios
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'
{
  "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"
}

Lists all portfolios with various filtering options.

​
userAddress
string

Filter portfolios by owner Ethereum address

​
portfolioId
string

Filter by portfolio ID

​
portfolioAddress
string

Filter by portfolio vault address

​
portfolioChainId
string

Filter by portfolio vault chain ID

​
isArchived
boolean

Filter for archived (true) or active (false) portfolios

​
hasAutomation
boolean

Filter for portfolios with automation enabled

​
limit
number
default:"20"

Number of results to return

​
offset
number
default:"0"

Pagination offset

​
sort
string
default:"created_at"

Sort field (options: created_at, updated_at, name)

​
order
string
default:"desc"

Sort order (options: asc, desc)

​
search
string

Text search term

​
chainId
string

Filter by chain ID

​
tag
string

Filter by portfolio tag

​
includeAssets
boolean
default:"true"

Include detailed asset data

​
realtime
boolean
default:"false"

Use real-time blockchain data instead of cached data

​
X-API-KEY
string
required

Your API key for authentication