Nexus/API Reference/Journal and Edge

Read one trading day

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

One trading day on one of your own accounts: the day's figures, the cash curve through the day and every trade that closed that day. Read only, and only yours.

  • date is the trading day in New York time (YYYY-MM-DD). Left out, it is today there. A date that isn't a day, or a day after today, answers 400 bad_request.
  • A trade belongs to the day it closed (an expired one to the day it expired).
  • A day with nothing closed is a 200 with stats: null and empty trades. It is never a row of zeros. A day with no cash move at all also has netChange: null and empty cashPoints.
  • startingBalance is the account's cash before the day began. cashPoints are the day's cash moves in time order, each with the balance after it. netChange is the last balance less startingBalance, so open and close cash moves both count: a day with only an open has stats: null and a netChange.
  • stats is the day's closed trades with the journal's own rules: counts, winRate, netPnl, avgWin, avgLoss, profitFactor, bestTrade and worstTrade. A figure that wasn't measured is null, never 0.
  • Closed spreads on your Main account count here as one closed position each, and show as one row with direction: "spread", strike: 0 and no percent fields. The Bot and your ports never hold a spread.
  • meta says which account and port were read. Beta: the shape may still grow new fields.
curl -s "https://app.skylit.ai/api/nexus/v1/journal/daily?date=2026-11-16&account=agent" \
  -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

  • accountstring

    main (your own simulated wallet, the default) or agent (your bot's).

    mainagent
  • portstringuuid

    One of your ports (see Ports in the Nexus Trades guide), by id. account, if you send it too, must agree: agent (or left out) for Bot and an extra port, left out for Main. Left out, account alone decides.

  • datestringdate

    The trading day, YYYY-MM-DD, New York time. Left out, today.

Responses

  • 200

    The day.

  • 400

    Code: bad_request. account, range, by or month isn't one of the allowed values, account doesn't agree with port, or Main was sent to agent/edge. The message says which.

  • 401

    No key, or a key that isn't valid. Codes: missing_api_key, invalid_api_key.

  • 403

    The key works but this can't be done. Codes: feature_disabled (ports are switched off on the server: leave port out), account_suspended, nexus_access_denied.

  • 404

    Codes: port_not_found (no live port with that id on your account), user_not_found (this Skylit account hasn't used Nexus yet, so it has no journal).

  • 429

    Over a rate limit. Wait Retry-After seconds, then retry. Codes: rate_limited, and stream_limit_reached (too many live streams open: 3 per key, 6 per account).

  • 500

    Something went wrong on our side. If you sent a clientOrderId, retry with the same one. Code: internal_error.

Response fields

  • dataobject
    • datestringdaterequired
    • timezonestringrequired
      America/New_York
    • statsobject | nullrequired

      The day's closed trades (closed and expired), with the journal's own rules. null when nothing closed that day. A ratio or average with nothing to measure is null, and its sample sits beside it.

    • startingBalancenumber | nullrequired

      The account's cash before the day began.

    • netChangenumber | nullrequired

      The last cash balance less startingBalance. null when no cash moved that day (an open alone moves cash).

    • cashPointsobject[]required

      The day's cash moves in time order.

    • tradesobject[]required

      Every trade that closed that day, as GET /v1/trades serves it.

  • metaobject

    Which account and port were read.

    • accountstring
      mainagent
    • portstring | nulluuid

      The port you sent, or null.

Last updated

Was this page helpful?