Nexus/API Reference/Journal and Edge

Your futures trades for a month

GEThttps://app.skylit.ai/api/nexus/v1/journal/futures/trades

Every futures trade (flat to flat) closed in a month of futures trading days, newest first, with each day's result and the month's totals. The Journal's futures trade list, by key. Read only: it never makes an account.

winRatePct, profitFactor, avgWinCents and avgLossCents are null when there is nothing to divide by. A figure nothing was measured for is null, never 0, next to the count it was taken over. Money is in cents and prices in index points. tripId opens one trade in full.

curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/trades?month=2026-11" \
  -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

  • monthstring

    YYYY-MM. Left out, the current month.

  • accountstring

    Which of your futures accounts: practice, agent (your bot's), evaluation or funded (when you have exactly one running), or one of your futures account ids. main or all is every account of yours except your agent's, as the Journal shows it. Left out, that same view, or your agent's account where keys default to it; meta.account says which was read. practice or agent before its first order, or an id that isn't yours, answers 404 account_not_found.

Responses

  • 200

    The read.

  • 400

    bad_request: month isn't YYYY-MM.

  • 401

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

  • 403

    futures_access_denied: futures aren't on for this account. Also account_suspended, nexus_access_denied.

  • 404

    account_not_found: practice or agent before its first order (a read never makes one), or an id that isn't one of your futures accounts. user_not_found: this Skylit account hasn't used Nexus yet.

  • 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.

  • 503

    futures_journal_unavailable: the futures journal isn't served by key on this server.

Response fields

  • dataobjectrequired

    A month of futures trades with each day's result and the month's totals.

    • monthstring

      YYYY-MM.

    • daysobject[]
    • tradesobject[]

      Newest first.

    • netCentsinteger
    • tradeCountinteger
    • winsinteger
    • lossesinteger
    • winRatePctnumber | null

      Wins over decided trades (a trade that nets exactly $0 is neither). null with none decided.

    • grossWinCentsinteger
    • grossLossCentsinteger

      A positive number.

    • profitFactornumber | null

      Gross win over gross loss. null with no losing trade (it would be infinite, not 0).

    • avgWinCentsinteger | null

      null with no winner.

    • avgLossCentsinteger | null

      A positive number. null with no loser.

  • metaobject

    Which account was read.

    • accountstring

      What was read: all (every account of yours but your agent's), a selector like practice or agent, or the account id you sent.

    • accountIdstring | nulluuid

      The account read. null for all.

Last updated

Was this page helpful?