Skip to main content

​
Description

Retrieves a list of closed trading positions (trades) with detailed profit/loss information, entry and exit prices, quantities, and holding times. Useful for displaying trade history, calculating performance metrics, and analyzing past trading decisions.

​
Input Schema

​
variant
VariantId
Filter trades by model variant. Valid values: "Apex", "Trendsurfer", "Contrarian", "Sovereign". Omit to fetch trades from all variants.
​
limit
number
Maximum number of trades to return. Must be between 1 and 500. Defaults to all available trades if not specified.

​
TypeScript Type

type TradesInput = {
  variant?: "Apex" | "Trendsurfer" | "Contrarian" | "Sovereign";
  limit?: number; // min: 1, max: 500
};

​
Output Schema

​
trades
Trade[]
Array of closed trade objects.

​
TypeScript Type

type TradesResponse = {
  trades: {
    id: string;
    modelId: string;
    modelName: string;
    modelVariant?: "Apex" | "Trendsurfer" | "Contrarian" | "Sovereign";
    modelRouterName?: string;
    modelKey?: string;
    side: "long" | "short";
    symbol: string;
    entryPrice: number;
    exitPrice: number;
    quantity: number;
    netPnl: number;
    openedAt: string;
    closedAt: string;
    holdingTime?: string;
    timestamp: string;
  }[];
};

​
Example Usage

​
Basic Query

import { useQuery } from "@tanstack/react-query";
import { orpc } from "@/server/orpc/client";

function TradesTable() {
  const { data, isLoading } = useQuery(
    orpc.trading.getTrades.queryOptions({
      input: { limit: 50 }
    })
  );

  if (isLoading) return <div>Loading trades...</div>;

  return (
    <table>
      <thead>
        <tr>
          <th>Symbol</th>
          <th>Side</th>
          <th>Entry</th>
          <th>Exit</th>
          <th>P&L</th>
          <th>Closed</th>
        </tr>
      </thead>
      <tbody>
        {data?.trades.map((trade) => (
          <tr key={trade.id}>
            <td>{trade.symbol}</td>
            <td>{trade.side.toUpperCase()}</td>
            <td>${trade.entryPrice.toFixed(2)}</td>
            <td>${trade.exitPrice.toFixed(2)}</td>
            <td style={{ color: trade.netPnl >= 0 ? 'green' : 'red' }}>
              ${trade.netPnl.toFixed(2)}
            </td>
            <td>{new Date(trade.closedAt).toLocaleDateString()}</td>
          </tr>
        ))}
      </tbody>
    </table>
  );
}

​
Filter by Variant

import { useQuery } from "@tanstack/react-query";
import { orpc } from "@/server/orpc/client";

function ApexTrades() {
  const { data } = useQuery(
    orpc.trading.getTrades.queryOptions({
      input: { 
        variant: "Apex",
        limit: 100 
      }
    })
  );

  const totalPnl = data?.trades.reduce((sum, t) => sum + t.netPnl, 0) ?? 0;
  const winRate = data?.trades.filter(t => t.netPnl > 0).length ?? 0 / (data?.trades.length ?? 1);

  return (
    <div>
      <h2>Apex Strategy Trades</h2>
      <p>Total P&L: ${totalPnl.toFixed(2)}</p>
      <p>Win Rate: {(winRate * 100).toFixed(1)}%</p>
      <ul>
        {data?.trades.map(trade => (
          <li key={trade.id}>
            {trade.symbol} {trade.side} - ${trade.netPnl.toFixed(2)}
          </li>
        ))}
      </ul>
    </div>
  );
}

​
Calculate Performance Metrics

import { useQuery } from "@tanstack/react-query";
import { orpc } from "@/server/orpc/client";

function PerformanceMetrics() {
  const { data } = useQuery(
    orpc.trading.getTrades.queryOptions({
      input: {}
    })
  );

  const trades = data?.trades ?? [];
  const winners = trades.filter(t => t.netPnl > 0);
  const losers = trades.filter(t => t.netPnl < 0);

  const winRate = trades.length > 0 ? (winners.length / trades.length) * 100 : 0;
  const avgWin = winners.length > 0 
    ? winners.reduce((sum, t) => sum + t.netPnl, 0) / winners.length 
    : 0;
  const avgLoss = losers.length > 0
    ? Math.abs(losers.reduce((sum, t) => sum + t.netPnl, 0) / losers.length)
    : 0;
  const expectancy = avgWin * (winRate / 100) - avgLoss * (1 - winRate / 100);

  return (
    <div>
      <h3>Performance Overview</h3>
      <p>Total Trades: {trades.length}</p>
      <p>Win Rate: {winRate.toFixed(1)}%</p>
      <p>Average Win: ${avgWin.toFixed(2)}</p>
      <p>Average Loss: ${avgLoss.toFixed(2)}</p>
      <p>Expectancy: ${expectancy.toFixed(2)}</p>
    </div>
  );
}

Build docs developers (and LLMs) love

Get started for freeTalk to us