PnL Analytics API

# Full PnL summary for a wallet
curl "https://api.stratiumsol.com/v1/pnl/wallet/7xKXLkq...9bPq" \
  -H "X-API-Key: sk_live_your_key"

# Paginated FIFO steps
curl "https://api.stratiumsol.com/v1/pnl/wallet/7xKXLkq...9bPq/steps?limit=50" \
  -H "X-API-Key: sk_live_your_key"

const API_KEY = process.env.STRATIUM_API_KEY!;
const BASE = "https://api.stratiumsol.com/v1";

// Full PnL summary
const pnl = await fetch(`${BASE}/pnl/wallet/${walletAddress}`, {
  headers: { "X-API-Key": API_KEY },
}).then((r) => r.json());

console.log(pnl.data.cumulative_pnl); // 142.8 SOL

// Paginated FIFO steps with audit trail
const steps = await fetch(
  `${BASE}/pnl/wallet/${walletAddress}/steps?limit=50&action=SELL`,
  { headers: { "X-API-Key": API_KEY } }
).then((r) => r.json());

for (const step of steps.data) {
  console.log(`${step.action} ${step.token_mint}: ${step.realized_pnl} SOL`);
  console.log("  Lots consumed:", step.acquisitions_used);
}

import os
import requests

API_KEY = os.environ["STRATIUM_API_KEY"]
BASE = "https://api.stratiumsol.com/v1"
HEADERS = {"X-API-Key": API_KEY}

# Full PnL summary
pnl = requests.get(f"{BASE}/pnl/wallet/{wallet_address}", headers=HEADERS).json()
print(f"Cumulative PnL: {pnl['data']['cumulative_pnl']} SOL")

# Paginated FIFO steps
steps = requests.get(
    f"{BASE}/pnl/wallet/{wallet_address}/steps",
    params={"limit": 50, "action": "SELL"},
    headers=HEADERS,
).json()
for step in steps["data"]:
    print(f"{step['action']} {step['token_mint']}: {step['realized_pnl']} SOL")

interface PnLSummary {
  wallet_address: string;
  total_trades: number;            // Total BUY + SELL count
  total_buys: number;
  total_sells: number;
  cumulative_pnl: number;          // Final running PnL (SOL)
  active_positions_count: number;  // Tokens still held
  capital_in_positions: number;    // SOL locked in open positions
  earliest_trade: string;          // ISO 8601
  latest_trade: string;            // ISO 8601
  calculation_version: number;
  was_truncated: boolean;          // true if > 500,000 trades
  calculated_at: string;           // ISO 8601
}

interface PnLStep {
  step_sequence: number;           // 0-based within calculation
  transaction_signature: string;   // Solana transaction signature
  timestamp: number;               // Unix milliseconds
  token_mint: string;              // Token mint address
  action: "BUY" | "SELL";         // Trade direction
  amount: number;                  // Token amount
  price_per_token: number;         // Execution price (SOL)
  total_value: number;             // amount * price_per_token
  cost_basis: number | null;       // SELL only: FIFO cost basis
  realized_pnl: number | null;    // SELL only: proceeds - cost_basis
  cumulative_pnl: number;          // Running PnL total
  remaining_position: number;      // Tokens still held after step
  capital_in_positions: number;    // Total SOL locked in open positions
  holding_time_seconds: number | null; // SELL only: time held
  token_roi_sol: number | null;    // SELL only: return on investment
  acquisitions_used: Array<{       // SELL only: BUY lots consumed
    signature: string;             //   Original BUY transaction
    amount: number;                //   Quantity from this lot
    price: number;                 //   Original purchase price
    timestamp: number;             //   When the BUY occurred
  }> | null;
}

{
  "success": true,
  "data": [
    {
      "step_sequence": 42,
      "transaction_signature": "3xKp9V...mN7q",
      "timestamp": 1712841600000,
      "token_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "action": "SELL",
      "amount": 1500.0,
      "price_per_token": 0.00245,
      "total_value": 3.675,
      "cost_basis": 2.85,
      "realized_pnl": 0.825,
      "cumulative_pnl": 14.32,
      "remaining_position": 0,
      "capital_in_positions": 8.42,
      "holding_time_seconds": 7200,
      "token_roi_sol": 28.95,
      "acquisitions_used": [
        {
          "signature": "5yRm2Q...kL4p",
          "amount": 1000.0,
          "price": 0.0019,
          "timestamp": 1712834400000
        },
        {
          "signature": "8wTn5K...jP2r",
          "amount": 500.0,
          "price": 0.0019,
          "timestamp": 1712836200000
        }
      ]
    }
  ],
  "meta": {
    "total": 156,
    "offset": 0,
    "limit": 50
  },
  "timestamp": "2026-04-14T12:00:00Z"
}