Portfolio Intelligence

Introduction

Portfolio Intelligence solves the problem of fragmented and opaque Stellar portfolios. Whether you're a power user with multiple accounts, a DAO managing treasury, or a fund tracking positions, Portfolio Intelligence gives you complete visibility into your holdings.

Dashboard

The Portfolio dashboard provides a comprehensive overview of your holdings across all linked accounts.

Key Metrics

Dashboard Sections

Subscription Tiers

Portfolio Intelligence offers three tiers to match your needs. Start free and upgrade as you grow.

Portfolios

A portfolio is a container for grouping Stellar accounts. You might create separate portfolios for personal holdings, trading, or different organizations.

Portfolio Properties

Account Management

Link Stellar accounts to your portfolio by providing the account ID (public key). Each account is validated against the Stellar network before being added.

Account Properties

Asset Positions

Asset positions represent your holdings in each asset. Positions are aggregated across all accounts in a portfolio, giving you a unified view of your total exposure.

Position Data

P&L TrackingPRO+

Track profit and loss across your portfolio with automatic trade import and FIFO cost basis calculation.

P&L Metrics

P&L by Time Period

Trustline Risk

Every non-XLM asset on Stellar requires a trustline to an issuer. Portfolio Intelligence assesses the risk of each trustline based on issuer flags and behavior.

Risk Factors

Risk Score

Each trustline receives a risk score from 0-100 based on weighted factors:

Risk Score = (
  authRequired * 25 +
  authRevocable * 20 +
  clawbackEnabled * 30 +
  !authImmutable * 15 +
  lowHolderCount * 10
)

Contract PositionsPRO+

Track your positions in Soroban smart contracts, including DeFi protocols, liquidity pools, and staking contracts.

Supported Position Types

Yield TrackingPRO+

Monitor yield from various sources including staking rewards, AMM fees, and lending interest.

Yield Sources

Yield Metrics

Performance Snapshots

Portfolio Intelligence automatically captures daily snapshots of your portfolio value, enabling historical performance analysis.

Snapshot Data

Retention by Tier

How-to: Create a Portfolio

1. 1

   Navigate to Portfolio

   Click "Portfolio" in the main navigation

2. 2

   Click "Create Portfolio"

   Opens the portfolio creation modal

3. 3

   Enter Portfolio Details

   Provide a name and optional description

4. 4

   Submit

   Your portfolio is created and ready for accounts

How-to: Add an Account

1. 1

   Open Your Portfolio

   Select the portfolio you want to add an account to

2. 2

   Click "Add Account"

   Opens the account addition modal

3. 3

   Enter Account ID

   Paste the Stellar public key (starts with G)

4. 4

   Add Label (Optional)

   Give it a friendly name like "Trading" or "Savings"

5. 5

   Submit

   Account is validated and added to your portfolio

How-to: Sync Portfolio Data

Portfolio data is synced automatically, but you can trigger a manual sync to get the latest balances.

1. 1

   Open Your Portfolio Dashboard

   Navigate to the portfolio you want to sync

2. 2

   Click the Sync Button

   Located in the summary section next to "Last synced"

3. 3

   Wait for Sync

   Data is fetched from Stellar Horizon for all accounts

Cost Basis (FIFO)

Portfolio Intelligence uses First-In-First-Out (FIFO) accounting to calculate cost basis and P&L. This is the most common method for tax reporting.

How FIFO Works

Example: You buy XLM at different prices

Buy 1: 1,000 XLM @ $0.10 = $100 cost basis
Buy 2: 500 XLM @ $0.12 = $60 cost basis
Buy 3: 200 XLM @ $0.15 = $30 cost basis

Total: 1,700 XLM, $190 cost basis

When you sell 1,200 XLM:
- First 1,000 XLM from Buy 1 ($100 cost)
- Next 200 XLM from Buy 2 ($24 cost, 200/500 * $60)
- Total cost basis for sale: $124

Remaining: 500 XLM
- 300 XLM from Buy 2 ($36 cost)
- 200 XLM from Buy 3 ($30 cost)
- Remaining cost basis: $66

Risk Scoring

Each trustline is assigned a risk score from 0-100 based on multiple factors.

Risk Levels

API Reference

Access Portfolio Intelligence programmatically via the REST API.

Example: Create Portfolio

curl -X POST "https://lumenquery.io/api/portfolio" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "name": "My Trading Portfolio",
    "description": "Active trading accounts"
  }'

Example: Add Account

curl -X POST "https://lumenquery.io/api/portfolio/{id}/accounts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "accountId": "GABC...XYZ",
    "label": "Main Trading"
  }'