Nexus/API Reference/Journal and Edge

Your season recap

GEThttps://app.skylit.ai/api/nexus/v1/journal/recap

One season (an Arc: a calendar quarter in New York time) on one of your accounts: trades, contracts, wins and losses, win rate, net P&L, profit factor, days traded, green and red days, your best and worst day, best trade, the ticker that paid most, the session that paid best on average, your longest green streak and the running net by day traded. Read only.

Left out, arc and year are the Arc in progress; one of them alone means that one with the current other. complete says whether the Arc has finished, so a season in progress reads as "so far".

A figure that hasn't been measured is null, never 0: winRate with no winning or losing trade, netPnl when no trade has a realized P&L (measuredTrades is 0), profitFactor with no losing trade. bestDay, worstDay, bestTrade, bestTicker, bestSession (needs 5 trades in it) and greenStreak (needs 2 green days) are null when there is none; curve is null under two days.

account is main (your simulated wallet) or agent (your bot's account); port is one of your ports. meta says which account and port were read.

curl -s "https://app.skylit.ai/api/nexus/v1/journal/recap?arc=3&year=2026&account=main" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"

Authorization

Authorization: Bearer <your API key>

Required. A missing header returns 401; an invalid, revoked or expired key returns 403.

Query parameters

  • arcintegermin 1 · max 4

    1 (January to March), 2 (April to June), 3 (July to September) or 4 (October to December).

  • yearinteger
  • accountstring

    Which of your accounts. Left out, your default account.

    mainagent
  • portstring

    One of your port ids (GET /v1/trading/ports). An account sent beside it must agree with it.

Responses

  • 200

    The season on that account.

  • 400

    bad_request: arc is not 1 to 4, account is not main or agent, or it does not agree with the port.

  • 401

    Missing or invalid key.

  • 404

    port_not_found: that port is not one of yours. user_not_found: this account has not used Nexus yet.

Response fields

  • dataobjectrequired
    • arcinteger
    • yearinteger
    • namestring
    • themestring
    • startDatestringdate
    • endDatestringdate

      The Arc's last day.

    • completeboolean
    • tradesinteger

      Closed and expired trades in the Arc.

    • contractsinteger
    • measuredTradesinteger

      Trades with a realized P&L. netPnl sums only these.

    • winsinteger
    • lossesinteger
    • breakeveninteger
    • activeDaysinteger
    • greenDaysinteger
    • redDaysinteger
    • winRatenumber | null

      Percent of winning and losing trades that won. null with neither.

    • netPnlnumber | null

      US dollars. null when measuredTrades is 0.

    • profitFactornumber | null

      Dollars won over dollars lost. null with no losing trade.

    • bestDayobject | null
    • worstDayobject | null
    • bestTradeobject | null
    • bestTickerobject | null
    • bestSessionobject | null
    • greenStreakobject | null
    • curvenumber[] | null

      Running net P&L in dollars, one point per day traded, oldest first.

  • metaobjectrequired
    • accountstring
      mainagent
    • portstring | null

Last updated

Was this page helpful?