Interface TickEvent

Unified tick event data for report generation. Contains all information about a tick event regardless of action type.

interface TickEvent {
    action:
        | "waiting"
        | "active"
        | "closed"
        | "idle"
        | "opened"
        | "scheduled"
        | "cancelled";
    cancelReason?: string;
    closeReason?: string;
    currentPrice: number;
    duration?: number;
    fallPnl?: number;
    note?: string;
    originalPriceOpen?: number;
    originalPriceStopLoss?: number;
    originalPriceTakeProfit?: number;
    partialExecuted?: number;
    peakPnl?: number;
    pendingAt?: number;
    percentSl?: number;
    percentTp?: number;
    pnl?: number;
    pnlCost?: number;
    pnlEntries?: number;
    position?: string;
    priceOpen?: number;
    priceStopLoss?: number;
    priceTakeProfit?: number;
    scheduledAt?: number;
    signalId?: string;
    symbol?: string;
    timestamp: number;
    totalEntries?: number;
    totalPartials?: number;
}

Properties

action:
    | "waiting"
    | "active"
    | "closed"
    | "idle"
    | "opened"
    | "scheduled"
    | "cancelled"

Event action type

cancelReason?: string

Cancel reason (only for cancelled)

closeReason?: string

Close reason (only for closed)

currentPrice: number

Current price

duration?: number

Duration in minutes (only for closed)

fallPnl?: number

Fall PNL percentage at worst price during position (_fall.pnlPercentage, only for closed)

note?: string

Signal note (only for scheduled/waiting/opened/active/closed/cancelled)

originalPriceOpen?: number

Original entry price at signal creation (unchanged by DCA averaging)

originalPriceStopLoss?: number

Original stop loss price before modifications (only for scheduled/waiting/opened/active/closed/cancelled)

originalPriceTakeProfit?: number

Original take profit price before modifications (only for scheduled/waiting/opened/active/closed/cancelled)

partialExecuted?: number

Total executed percentage from partial closes (only for scheduled/waiting/opened/active/closed/cancelled)

peakPnl?: number

Peak PNL percentage at best price during position (_peak.pnlPercentage, only for closed)

pendingAt?: number

Timestamp when position became active (only for opened/active/closed)

percentSl?: number

Percentage progress towards stop loss (only for active/waiting)

percentTp?: number

Percentage progress towards take profit (only for active/waiting)

pnl?: number

PNL percentage (for active/waiting: unrealized, for closed: realized)

pnlCost?: number

Absolute profit/loss in USD (for active/waiting: unrealized, for closed: realized)

pnlEntries?: number

Total invested capital in USD

position?: string

Position type (only for scheduled/waiting/opened/active/closed/cancelled)

priceOpen?: number

Open price (only for scheduled/waiting/opened/active/closed/cancelled)

priceStopLoss?: number

Stop loss price (only for scheduled/waiting/opened/active/closed/cancelled)

priceTakeProfit?: number

Take profit price (only for scheduled/waiting/opened/active/closed/cancelled)

scheduledAt?: number

Timestamp when signal was created/scheduled (only for scheduled/waiting/opened/active/closed/cancelled)

signalId?: string

Signal ID (only for scheduled/waiting/opened/active/closed/cancelled)

symbol?: string

Trading pair symbol (only for non-idle events)

timestamp: number

Event timestamp in milliseconds (scheduledAt for scheduled events, pendingAt for opened/closed events)

totalEntries?: number

Total number of DCA entries (_entry.length). 1 = no averaging.

totalPartials?: number

Total number of partial closes executed (_partial.length)