GET /orders/{orderId} returns the full execution report: fill prices, fees earned, gas costs, venue routing, and onchain confirmation status. Use this data to build post-trade dashboards, reconcile revenue, or feed analytics into your product.
Order-level summary
The response includes anorder.filled object with aggregated execution data across all fills:
Per-fill detail
Each entry in thefills array represents a single execution event. For TWAP orders, each time slice produces its own fill; for other order types, there is typically one fill per order.
Pricing and amounts
Fee breakdown
Execution metadata
Common use cases
Revenue tracking. Your integrator fee is what routes to your Definitive vault:integratorFeeAmount is the fee in feeTicker, and integratorFeeNotional is its USD value. Sum integratorFeeNotional across fills for your total earnings in USD. tradeFeeNotional is Definitive’s own platform fee.
Execution quality reporting. Compare filled.averageNotionalPrice against the quote price to measure realized slippage. Use venues to see which liquidity sources contributed to each fill.
Gas cost accounting. Use networkFeeNotional per fill to track gas costs.
TWAP fill analysis. For TWAP orders, each time slice has its own fill entry with an independent fillPrice, filledAt, and venues. Use the full fills array to chart execution across the TWAP window and verify price distribution.
Get Order endpoint
Full response schema for
GET /orders/{orderId}.Monetize Your Integration
Set your integrator fee and reconcile earnings from each fill.