Skip to main content
POST
Recalculate a conditional option scenario

Authorizations

Authorization
string
header
required

Joyride Core session JWT obtained from the SIWS flow (public/get_nonce + public/auth on the Core trading WebSocket). Include as: Authorization: Bearer <jwt>

Body

application/json
input_revision
integer
required
Required range: x >= 0
anonymous_id
string
conversation_id
string<uuid>
origin_message_id
string<uuid>
origin_analysis_id
string
selected_card
object
instrument
string
quantity
string

Hypothetical positive decimal contracts

side
enum<string>

Hypothetical or unfilled proposal side; required for a two-way proposal

Available options:
buy,
sell
basis
enum<string>
Available options:
hypothetical
package_premium
string

Assumed whole-package ask for buy or bid for sell in USD; negative prices reverse the cash flow; omit when unknown

entry_fee
string

Assumed entry fee in USD; omit when unknown

settlement_prices
string[]
Maximum array length: 81
time_basis
enum<string>
Available options:
settlement,
early_exit

Response

Analysis for the supplied input revision; discard obsolete client revisions

Decimal strings in USD/contracts. Conditional settlement-reference math, not an executable quote or promised chain receipt. Actual entry fee is separate from signed fee maximum. Remaining cost basis is not inferred.

analysis_id
string
basis_revision
string
input_revision
integer
Required range: x >= 0
basis
enum<string>
Available options:
hypothetical,
executed
side
enum<string>
Available options:
buy,
sell
source_ids
string[]
observed_at_ms
integer<int64>
finality
string | null
legs
object[]
Maximum array length: 8
entry_cash_delta_usdc
string | null
actual_fee_usdc
string | null
signed_fee_maximum_usdc
string | null
bounds_cost_basis
string
maximum_loss
object

Only finite bounds carry amount_usdc; unavailable bounds carry a reason.

maximum_profit
object

Only finite bounds carry amount_usdc; unavailable bounds carry a reason.

breakeven_references_usdc
string[]
scenarios
object[]
Maximum array length: 81
early_exit
object

Unavailable until authoritative settlement timing/method and a supported valuation basis exist.

remaining_cost_basis
string
limitations
string[]