Read one trading day
https://app.skylit.ai/api/nexus/v1/journal/dailyOne 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.
dateis 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, answers400 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
200withstats: nulland emptytrades. It is never a row of zeros. A day with no cash move at all also hasnetChange: nulland emptycashPoints. startingBalanceis the account's cash before the day began.cashPointsare the day's cash moves in time order, each with the balance after it.netChangeis the last balance lessstartingBalance, so open and close cash moves both count: a day with only an open hasstats: nulland anetChange.statsis the day's closed trades with the journal's own rules: counts,winRate,netPnl,avgWin,avgLoss,profitFactor,bestTradeandworstTrade. A figure that wasn't measured isnull, never0.- Closed spreads on your Main account count here as one closed position each, and show as one row with
direction: "spread",strike: 0and no percent fields. The Bot and your ports never hold a spread. metasays 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
accountstringmain(your own simulated wallet, the default) oragent(your bot's).mainagentportstringuuidOne 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,accountalone decides.datestringdateThe trading day,
YYYY-MM-DD, New York time. Left out, today.
Responses
- 200
The day.
- 400
Code:
bad_request.account,range,byormonthisn't one of the allowed values,accountdoesn't agree withport, or Main was sent toagent/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: leaveportout),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-Afterseconds, then retry. Codes:rate_limited, andstream_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
dataobjectdatestringdaterequiredtimezonestringrequiredAmerica/New_Yorkstatsobject | nullrequiredThe day's closed trades (closed and expired), with the journal's own rules.
nullwhen nothing closed that day. A ratio or average with nothing to measure isnull, and its sample sits beside it.startingBalancenumber | nullrequiredThe account's cash before the day began.
netChangenumber | nullrequiredThe last cash balance less
startingBalance.nullwhen no cash moved that day (an open alone moves cash).cashPointsobject[]requiredThe day's cash moves in time order.
tradesobject[]requiredEvery trade that closed that day, as
GET /v1/tradesserves it.
metaobjectWhich account and port were read.
accountstringmainagentportstring | nulluuidThe port you sent, or
null.
Last updated