RawPositionNotification
The raw position-state notification frame as it arrives on the wire (snake_case), mirroring the hedger/solver payload. Consumers normally receive the normalized Notification; the raw frame is retained on it as raw.
The endpoint omits fields that do not apply to a given frame (for example an InstantRFQ report carries no id), so almost every field is optional; normalizeNotification fills sensible defaults.
Fields
idstringoptionalquote_idnumberoptionalOn-chain quote id, or 0 while the order is still off-chain.
temp_quote_idnumberoptionalNegative placeholder id assigned before the on-chain quote id exists.
create_timenumberoptionalmodify_timenumberoptionalcounterparty_addressstringoptionaladdressstringoptionalSubAccount address the notification belongs to.
va_addressstringoptionalSolver-assigned Virtual Account address (lowcap), when present.
filled_amount_openstring | nulloptionalfilled_amount_closestring | nulloptionallast_seen_actionstring | nulloptionalLast solver action seen for this quote (e.g. SendQuoteTransaction).
action_statusstring | nulloptionalsuccess | failed | seen.
failure_typestring | nulloptionalfailure_messagestring | nulloptionalerror_codenumber | nulloptionalstate_typestring | nulloptionalreport | alert.
versionnumberoptionalavg_price_openstringoptionalavg_price_closestringoptionalDefilyticsNotificationEnvelope
The defilytics endpoint nests the notification under data, with the SubAccount address hoisted to the top level. parseNotificationFrame unwraps it back into a RawPositionNotification.
dataRawPositionNotificationThe nested notification frame.
addressstringThe SubAccount address, hoisted to the envelope root.
Related
- Notification — the normalized shape this becomes.
- parseNotificationFrame — parses an inbound frame into this type.