One futures trade in full
https://app.skylit.ai/api/nexus/v1/journal/futures/trips/{id}One of your futures trades: its fills, the path price took while it was open, and how far that went for and against you, in points per contract from the average entry. Read only.
closedAt, avgExitPrice, exitPoints and givebackPoints are null while it is open. Someone else's trade answers 404 trip_not_found, the same as one that doesn't exist.
curl -s "https://app.skylit.ai/api/nexus/v1/journal/futures/trips/cb6f0fe2-33a5-431a-a4de-3daefb8464b6" \
-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.
Path parameters
idstringuuidrequiredThe trade's
tripId(fromGET /api/nexus/v1/journal/futures/trades).
Responses
- 200
The read.
- 400
bad_request: the id isn't a UUID. - 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. Alsoaccount_suspended,nexus_access_denied. - 404
trip_not_found: not one of your trades.user_not_found: this Skylit account hasn't used Nexus yet. - 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. - 503
futures_journal_unavailable: the futures journal isn't served by key on this server.
Response fields
dataobjectrequiredOne futures trade in full. Excursions are in points per contract from the average entry.
idstringuuidaccountIdstringuuidaccountNamestringsymbolstringrootstringsidestringlongshortopenedAtstringdate-timeclosedAtstring | nulldate-timenullwhile it is open.maxQtyintegercontractsintegerClosed so far.
avgEntryPricenumberavgExitPricenumber | nullnullwhile open, or when a reset ended it.highPricenumberhighAtstringdate-timelowPricenumberlowAtstringdate-timebestPointsnumberPoints per contract in the trade's favour (0 if it never went there).
worstPointsnumberPoints per contract against it (0 or below).
exitPointsnumber | nullnullwhile open, or when a reset ended it.givebackPointsnumber | nullBest minus exit.
nullwhile open, or when a reset ended it.pointValueCentsintegertickSizenumbergrossCentsintegerRealised so far.
feesCentsintegernetCentsintegerfillsobject[]pathobject[]The price while it was open.
notestringYour note, or an empty string.
exitReasonstringSent only as
reset: a practice account reset cleared the position with no closing fill.reset
Last updated