Order
A trading order with its current state and execution details. This is the unified API representation of an order across its lifecycle, combining data from execution reports, order status queries, and parent/child tracking.
Properties
| Name | Type | Description |
|---|---|---|
| account_id | object | Account placing the order |
| average_fill_price | stringnull | Average fill price across all executions. For multileg orders this is the venue's strategy-level average when reported, else the signed net package price derived from the leg averages: net debit posit |
| client_order_id | string | Client-provided identifier echoed back. |
| created_at | string | Timestamp when order was created (UTC) |
| details | array | Contains execution, rejection or cancellation details, if any |
| expires_at | stringnull | Timestamp when the order will expire (UTC). Present when time_in_force is GOOD_TILL_DATE. When a null/undefined value is observed, it indicates it does not apply. |
| extended_hours | booleannull | Whether the order is eligible for extended-hours trading. |
| filled_quantity | string | Cumulative filled quantity |
| id | string | Engine-assigned unique identifier for this order (UUID). |
| instrument_id | stringnull | Instrument identifier for the traded instrument. `null` when the order is a multileg strategy whose legs are reported individually in `legs[]`. When a null/undefined value is observed, it indicates it |
| instrument_type | object | |
| leaves_quantity | string | Remaining unfilled quantity |
| limit_offset | stringnull | Limit offset for trailing stop-limit orders (signed) When a null/undefined value is observed, it indicates it does not apply. |
| limit_price | stringnull | Limit price (for LIMIT and STOP_LIMIT orders) When a null/undefined value is observed, it indicates it does not apply. |
| order_type | object | Type of order (MARKET, LIMIT, etc.) |
| quantity | string | Total order quantity |
| queue_state | object | |
| releases_at | stringnull | Scheduled release time for orders awaiting release. When a null/undefined value is observed, it indicates it does not apply. |
| side | object | Side of the order (BUY or SELL) |
| status | object | Current status of the order |
| stop_price | stringnull | Stop price (for STOP and STOP_LIMIT orders) When a null/undefined value is observed, it indicates it does not apply. |
| strategy | object | The execution strategy the order was submitted with, if any. |
| symbol | stringnull | Trading symbol. `null` when the order is a multileg strategy whose legs are reported individually in `legs[]`. When a null/undefined value is observed, it indicates it does not apply. |
| time_in_force | object | Time in force instruction |
| trailing_limit_px | stringnull | Current trailing limit price computed by the trailing strategy When a null/undefined value is observed, it indicates it does not apply. |
| trailing_offset | stringnull | Trailing offset amount for trailing orders When a null/undefined value is observed, it indicates it does not apply. |
| trailing_offset_type | object | |
| trailing_stop_px | stringnull | Current trailing stop price computed by the trailing strategy When a null/undefined value is observed, it indicates it does not apply. |
| trailing_watermark_px | stringnull | Trailing watermark price for trailing orders. Strategy-computed, so it is absent on the order-submission acknowledgement and only appears once fetched via the order fetch or list endpoints. When a nul |
| trailing_watermark_ts | stringnull | Trailing watermark timestamp for trailing orders. Strategy-computed, so it is absent on the order-submission acknowledgement and only appears once fetched via the order fetch or list endpoints. When a |
| underlying_instrument_id | stringnull | Instrument ID of the option's underlying instrument. Populated only for options orders. A `null` means one of two things: the order is not an option, so the field does not apply; or the order is an op |
| underlying_instrument_type | object | |
| updated_at | string | Timestamp of the most recent update (UTC) |
| venue | string | MIC code of the venue where the order is routed |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/clearstreet8e71/main/json-schema/clearstreet8e71-order-schema.json",
"title": "Order",
"description": "A trading order with its current state and execution details.\n\nThis is the unified API representation of an order across its lifecycle,\ncombining data from execution reports, order status queries, and parent/child tracking.",
"x-generated": "2026-10-09",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/clearstreet8e71-openapi.yaml#/components/schemas/Order",
"type": "object",
"required": [
"id",
"client_order_id",
"account_id",
"venue",
"side",
"quantity",
"order_type",
"time_in_force",
"status",
"filled_quantity",
"leaves_quantity",
"created_at",
"updated_at"
],
"properties": {
"account_id": {
"$ref": "#/$defs/i64",
"description": "Account placing the order"
},
"average_fill_price": {
"type": [
"string",
"null"
],
"description": "Average fill price across all executions. For multileg orders this is the venue's\nstrategy-level average when reported, else the signed net package price derived from\nthe leg averages: net debit positive, net credit negative, zero possible.\nWhen a null/undefined value is observed, it indicates that there is no available data."
},
"client_order_id": {
"type": "string",
"description": "Client-provided identifier echoed back."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "Timestamp when order was created (UTC)"
},
"details": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contains execution, rejection or cancellation details, if any"
},
"expires_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Timestamp when the order will expire (UTC). Present when time_in_force is GOOD_TILL_DATE.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"extended_hours": {
"type": [
"boolean",
"null"
],
"description": "Whether the order is eligible for extended-hours trading."
},
"filled_quantity": {
"type": "string",
"description": "Cumulative filled quantity"
},
"id": {
"type": "string",
"description": "Engine-assigned unique identifier for this order (UUID)."
},
"instrument_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Instrument identifier for the traded instrument. `null` when the order is a\nmultileg strategy whose legs are reported individually in `legs[]`.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"instrument_type": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/$defs/SecurityType",
"description": "Type of security. `null` when the order is a multileg strategy whose legs are\nreported individually in `legs[]`.\nWhen a null/undefined value is observed, it indicates it does not apply."
}
]
},
"leaves_quantity": {
"type": "string",
"description": "Remaining unfilled quantity"
},
"limit_offset": {
"type": [
"string",
"null"
],
"description": "Limit offset for trailing stop-limit orders (signed)\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"limit_price": {
"type": [
"string",
"null"
],
"description": "Limit price (for LIMIT and STOP_LIMIT orders)\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"order_type": {
"$ref": "#/$defs/OrderType",
"description": "Type of order (MARKET, LIMIT, etc.)"
},
"quantity": {
"type": "string",
"description": "Total order quantity"
},
"queue_state": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/$defs/QueueState",
"description": "Parent order queue state, present when the order is awaiting release or released.\nWhen a null/undefined value is observed, it indicates it does not apply."
}
]
},
"releases_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Scheduled release time for orders awaiting release.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"side": {
"$ref": "#/$defs/Side",
"description": "Side of the order (BUY or SELL)"
},
"status": {
"$ref": "#/$defs/OrderStatus",
"description": "Current status of the order"
},
"stop_price": {
"type": [
"string",
"null"
],
"description": "Stop price (for STOP and STOP_LIMIT orders)\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"strategy": {
"type": "object",
"description": "The execution strategy the order was submitted with, if any.",
"required": [
"type"
],
"properties": {
"destination": {
"type": "string",
"description": "Venue code the order is routed to. DMA only."
},
"end_at": {
"type": "string",
"format": "date-time",
"description": "UTC timestamp (RFC 3339) at which execution ends."
},
"start_at": {
"type": "string",
"format": "date-time",
"description": "UTC timestamp (RFC 3339) at which execution begins."
},
"type": {
"type": "string",
"description": "Execution strategy type.",
"enum": [
"SOR",
"VWAP",
"TWAP",
"DMA"
]
}
},
"additionalProperties": true
},
"symbol": {
"type": [
"string",
"null"
],
"description": "Trading symbol. `null` when the order is a multileg strategy whose legs are\nreported individually in `legs[]`.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"time_in_force": {
"$ref": "#/$defs/TimeInForce",
"description": "Time in force instruction"
},
"trailing_limit_px": {
"type": [
"string",
"null"
],
"description": "Current trailing limit price computed by the trailing strategy\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"trailing_offset": {
"type": [
"string",
"null"
],
"description": "Trailing offset amount for trailing orders\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"trailing_offset_type": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/$defs/TrailingOffsetType",
"description": "Trailing offset type for trailing orders\nWhen a null/undefined value is observed, it indicates it does not apply."
}
]
},
"trailing_stop_px": {
"type": [
"string",
"null"
],
"description": "Current trailing stop price computed by the trailing strategy\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"trailing_watermark_px": {
"type": [
"string",
"null"
],
"description": "Trailing watermark price for trailing orders. Strategy-computed, so it\nis absent on the order-submission acknowledgement and only appears\nonce fetched via the order fetch or list endpoints.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"trailing_watermark_ts": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Trailing watermark timestamp for trailing orders. Strategy-computed, so\nit is absent on the order-submission acknowledgement and only appears\nonce fetched via the order fetch or list endpoints.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"underlying_instrument_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Instrument ID of the option's underlying instrument. Populated only for\noptions orders. A `null` means one of two things: the order is not an\noption, so the field does not apply; or the order is an option whose\nunderlier has not yet been resolved.\nWhen a null/undefined value is observed, it indicates it does not apply."
},
"underlying_instrument_type": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/$defs/SecurityType",
"description": "Type of the underlying instrument, alongside `underlying_instrument_id`.\nWhen a null/undefined value is observed, it indicates it does not apply."
}
]
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "Timestamp of the most recent update (UTC)"
},
"venue": {
"type": "string",
"description": "MIC code of the venue where the order is routed"
}
},
"$defs": {
"OrderStatus": {
"type": "string",
"description": "Order status",
"enum": [
"PENDING_NEW",
"QUEUED",
"PENDING_TRIGGER",
"NEW",
"PARTIALLY_FILLED",
"FILLED",
"CANCELED",
"REJECTED",
"EXPIRED",
"PENDING_CANCEL",
"PENDING_REPLACE",
"REPLACED",
"DONE_FOR_DAY",
"STOPPED",
"SUSPENDED",
"CALCULATED",
"OTHER"
]
},
"OrderType": {
"type": "string",
"description": "Order type",
"enum": [
"MARKET",
"LIMIT",
"STOP",
"STOP_LIMIT",
"TRAILING_STOP",
"TRAILING_STOP_LIMIT",
"OTHER"
]
},
"QueueState": {
"type": "string",
"description": "Parent order queue or hold state.",
"enum": [
"AWAITING_RELEASE",
"RELEASED"
]
},
"SecurityType": {
"type": "string",
"description": "Security type",
"enum": [
"COMMON_STOCK",
"INDEX",
"OPTION",
"CASH"
]
},
"Side": {
"type": "string",
"description": "Side of the order (BUY or SELL).",
"enum": [
"BUY",
"SELL"
]
},
"TimeInForce": {
"type": "string",
"description": "Time in force",
"enum": [
"DAY",
"GOOD_TILL_CANCEL",
"IMMEDIATE_OR_CANCEL",
"FILL_OR_KILL",
"GOOD_TILL_DATE",
"AT_OPEN",
"AT_CLOSE",
"OTHER"
]
},
"TrailingOffsetType": {
"type": "string",
"description": "Trailing offset type for trailing stop orders.",
"enum": [
"PRICE",
"BPS"
]
},
"i64": {
"type": "integer",
"format": "int64"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/clearstreet8e71-order"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.