Skip to main content
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
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"
}