Nexus/API Reference/Journal and Edge

Your futures trading behaviour

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

Where your expectancy comes from, how the previous trade changes the next one, whether size and adding to a loser work, a daily stop what-if, and how far trades went for and against you per instrument (medians, trades with a recorded path only). The Journal's futures behaviour panel, by key. Read only.

Every bucket carries its trade count, empty ones included. 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.

curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/behaviour?range=7d&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

  • rangestringdefault 30d

    How far back, in futures trading days (a day runs from 6 PM ET the evening before): the last 7, 30 or 90 calendar days, the year so far, or all. Left out, 30d.

    7d30d90dytdall
  • 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: range isn't one of the list.

  • 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

    How you trade futures over a range.

    • rangestring
      7d30d90dytdall
    • fromstringdate
    • tostringdate
    • tradesinteger
    • expectancyobject

      Where expectancy comes from.

    • afterPreviousobject[]

      Each trade by the account's previous trade that day: first of the day, after a win or scratch, after a loss, within 5m of a loss.

    • sizingobject[]

      By instrument and peak contracts: NQ 1, NQ 2-3, NQ 4-9, NQ 10+, each with points per contract.

    • averagingobject[]

      one entry, added while winning, added to a loser.

    • dailyStopobject

      A daily stop what-if over closed trades only. It assumes skipped trades would have gone the way they did.

    • excursionsobject[]

      Per instrument, trades with a recorded path only.

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