{
"version": "V1.6.0",
"event_name": "STOCKS_ORDER",
"event_type": "stocks.order.processing",
"event_id": "01a0c198-773f-7647-a938-6f46df294ff2",
"source_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"data": {
"business_event_id": "46fedc3a-0858-5458-829e-6caa6b22a963",
"occurred_at": "2026-09-21T01:33:08.5888437Z",
"order": {
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"cash_amount": null,
"client_reference": "stocks-docs-20260921-buy-01",
"completed_at": null,
"created_at": "2026-09-21T01:33:08.629Z",
"executed_price": null,
"executed_quantity": null,
"failed_at": null,
"failure_code": null,
"failure_message": null,
"fees": null,
"funding_currency": "USDC",
"network": "Ethereum",
"order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"quoted_quantity": "0.00297066689243735",
"side": "BUY",
"status": "PENDING",
"symbol": "AAPLx",
"total_amount": null,
"transaction_hash": null,
"updated_at": "2026-09-21T01:33:08.5888437Z"
}
}
}Stocks
Stocks order
Receive processing, completed, and failed status notifications for Stocks orders.
WEBHOOK
stocksOrder
{
"version": "V1.6.0",
"event_name": "STOCKS_ORDER",
"event_type": "stocks.order.processing",
"event_id": "01a0c198-773f-7647-a938-6f46df294ff2",
"source_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"data": {
"business_event_id": "46fedc3a-0858-5458-829e-6caa6b22a963",
"occurred_at": "2026-09-21T01:33:08.5888437Z",
"order": {
"asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
"cash_amount": null,
"client_reference": "stocks-docs-20260921-buy-01",
"completed_at": null,
"created_at": "2026-09-21T01:33:08.629Z",
"executed_price": null,
"executed_quantity": null,
"failed_at": null,
"failure_code": null,
"failure_message": null,
"fees": null,
"funding_currency": "USDC",
"network": "Ethereum",
"order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
"quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
"quoted_quantity": "0.00297066689243735",
"side": "BUY",
"status": "PENDING",
"symbol": "AAPLx",
"total_amount": null,
"transaction_hash": null,
"updated_at": "2026-09-21T01:33:08.5888437Z"
}
}
}Event types
All order notifications useevent_name: STOCKS_ORDER. The event_type identifies the order stage.
| Event type | Order status | Meaning |
|---|---|---|
stocks.order.processing | PENDING | The order was accepted. Execution data that is not yet known remains null. |
stocks.order.completed | SUCCESS | Settlement completed. Use actual execution values for reconciliation. |
stocks.order.failed | FAILED | The order reached a final failure state. Quote rejection without an order does not produce this event. |
Order snapshot
The three events share the envelope and order field definitions below.data.order is the order snapshot at the time of the event.
- Processing:
completed_at,failed_at,failure_code, andfailure_messageare null. - Completed:
completed_athas a value and failure fields are null. Execution quantity, cash amount, fees, and total amount are provided; the execution price can be null when no settlement price is available. - Failed:
failed_at,failure_code, andfailure_messagehave values;completed_atis null. Execution quantities, amounts, and fees remain null. Failure codes includeSTOCKS_ORDER_FAILEDandSTOCKS_QUOTE_EXPIREDfor an order whose quote expires before execution.
Handle notifications
Notifications can be duplicated or arrive out of order. Do not roll back a terminal order state when a processing notification arrives later. A delivery timeout or missing transaction hash does not by itself indicate order failure. Follow Receive order Webhooks for signature verification, persistence, and delivery and business event deduplication. Use Retrieve an order to reconcile the current result.Body
application/json
Version configured for the webhook subscription.
Available options:
STOCKS_ORDER Available options:
stocks.order.processing, stocks.order.completed, stocks.order.failed Notification identifier. HTTP retries of the same delivery record retain this identifier.
Order identifier; equals data.order.order_id.
Show child attributes
Show child attributes
Response
Event durably received.