{"__v":0,"_id":"56940ce773f48f0d0075c9df","category":{"__v":8,"_id":"56940bc2d8c04d1700e5adb6","pages":["56940ce773f48f0d0075c9df","56941dd246b943190027fdf8","5694325e5f1c951900644d0a","569443761005590d0062cacc","5694450e46b943190027fe45","569511bcfe18811700c9bf59","56951873dcaf0d1700cb86a3","56951a76caa32519009c40f4"],"project":"563cc7119799fb0d00047685","version":"563cc7119799fb0d00047688","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-01-11T20:08:34.666Z","from_sync":false,"order":4,"slug":"orders","title":"Orders"},"editedParams":true,"editedParams2":true,"parentDoc":null,"project":"563cc7119799fb0d00047685","user":"563cc6fa8894d20d00014ea3","version":{"__v":16,"_id":"563cc7119799fb0d00047688","project":"563cc7119799fb0d00047685","createdAt":"2015-11-06T15:28:17.683Z","releaseDate":"2015-11-06T15:28:17.683Z","categories":["563cc7129799fb0d00047689","566f37f37ffa002300c3cd5b","56914e9bd47b020d002225ac","5692b19ffe72e00d00e4f0a8","56940bc2d8c04d1700e5adb6","56940bc83e9d080d00f064f0","56951b2dfcb1032d0089df7a","569522aecaa32519009c410c","569523ce562335190016da97","569523fddcaf0d1700cb86bf","56980e4a8560a60d00e2c3c3","569921a41693520d002e1305","5699323b7465970d00650b82","569e6cc4fbee990d0072d927","56a2768a0aefae0d00b7fe66","5862e862b8b7fa23009665b7"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Model T","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-11T20:13:27.462Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"http","code":"GET /v1/orders/DA.5f674a8a-203e-49a3-b474-7bb271c61507 HTTP/1.1\nHost: api.drivewealth.io\nAccept: application/json\nContent-Type: application/json\nx-mysolomeo-session-key: 02e57c7d-d071-4c63-b491-1194a9939ea5.2016-01-13T22:34:53.101Z"},{"code":"curl -X GET -H \"Accept: application/json\" -H \"Content-Type: application/json\" -H \"x-mysolomeo-session-key: 02e57c7d-d071-4c63-b491-1194a9939ea5.2016-01-13T22:34:53.101Z\" 'http://api.drivewealth.io/v1/orders/DA.c69f5f51-04ce-4796-a748-67306cdbcb17'","language":"curl"}]},"method":"get","results":{"codes":[{"name":"New","code":"/*\nA market order is successfully accepted when:\n\n1. \"orderQty\" is equal to \"leavesQty\".\n2. \"execType\" and \"ordStatus\" are both equal to \"0\".\n*/\n\n{\n    \"orderID\": \"DA.c69f5f51-04ce-4796-a748-67306cdbcb17\",\n    \"accountID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5.1452548617456\",\n    \"userID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"cumQty\": 0,\n    \"accountNo\": \"DWTE000005\",\n    \"commission\": 0,\n    \"createdByID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"createdWhen\": \"2016-01-11T22:01:09.066Z\",\n    \"execType\": \"0\",\n    \"grossTradeAmt\": 0,\n    \"instrumentID\": \"675cc7c2-e24b-42fa-9d1f-4b3a97ae8d2f\",\n    \"lastPx\": 0,\n    \"lastQty\": 0,\n    \"leavesQty\": 3,\n    \"orderNo\": \"DAQB000017\",\n    \"orderQty\": 3,\n    \"ordStatus\": \"0\",\n    \"ordType\": \"1\",\n    \"price\": 0,\n    \"rateAsk\": 0,\n    \"rateBid\": 0,\n    \"side\": \"B\",\n    \"accountType\": 2,\n    \"autoStop\": 0,\n    \"limitPrice\": 0,\n    \"timeInForce\": \"0\",\n    \"isoTimeRestingOrderExpires\": \"2016-01-12T21:00:00.000Z\",\n    \"internalMemo\": \"OGW ACH\",\n    \"amountCash\": 0\n}","language":"json","status":200},{"name":"Filled","status":200,"language":"json","code":"/*\nA market order is successfully filled when:\n\n1. \"orderQty\" is equal to \"cumQty\".\n2. \"execType\" and \"ordStatus\" are both equal to \"2\".\n*/\n\n{\n    \"orderID\": \"DA.c69f5f51-04ce-4796-a748-67306cdbcb17\",\n    \"accountID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5.1452548617456\",\n    \"userID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"cumQty\": 3,\n    \"accountNo\": \"DWTE000005\",\n    \"commission\": 0,\n    \"createdByID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"createdWhen\": \"2016-01-11T22:01:09.066Z\",\n    \"execType\": \"2\",\n    \"grossTradeAmt\": 0,\n    \"instrumentID\": \"675cc7c2-e24b-42fa-9d1f-4b3a97ae8d2f\",\n    \"lastPx\": 0,\n    \"lastQty\": 0,\n    \"leavesQty\": 3,\n    \"orderNo\": \"DAQB000017\",\n    \"orderQty\": 3,\n    \"ordStatus\": \"2\",\n    \"ordType\": \"1\",\n    \"price\": 0,\n    \"rateAsk\": 0,\n    \"rateBid\": 0,\n    \"side\": \"B\",\n    \"accountType\": 2,\n    \"autoStop\": 0,\n    \"limitPrice\": 0,\n    \"timeInForce\": \"0\",\n    \"isoTimeRestingOrderExpires\": \"2016-01-12T21:00:00.000Z\",\n    \"internalMemo\": \"OGW ACH\",\n    \"amountCash\": 0\n}"},{"code":"/*\nA market order is partially filled when:\n\n1. \"orderQty\" is less than \"cumQty\".\n2. \"execType\" and \"ordStatus\" are both equal to \"1\".\n*/\n\n{\n    \"orderID\": \"DA.c69f5f51-04ce-4796-a748-67306cdbcb17\",\n    \"accountID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5.1452548617456\",\n    \"userID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"cumQty\": 3,\n    \"accountNo\": \"DWTE000005\",\n    \"commission\": 0,\n    \"createdByID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"createdWhen\": \"2016-01-11T22:01:09.066Z\",\n    \"execType\": \"1\",\n    \"grossTradeAmt\": 0,\n    \"instrumentID\": \"675cc7c2-e24b-42fa-9d1f-4b3a97ae8d2f\",\n    \"lastPx\": 0,\n    \"lastQty\": 0,\n    \"leavesQty\": 3,\n    \"orderNo\": \"DAQB000017\",\n    \"orderQty\": 1,\n    \"ordStatus\": \"1\",\n    \"ordType\": \"1\",\n    \"price\": 0,\n    \"rateAsk\": 0,\n    \"rateBid\": 0,\n    \"side\": \"B\",\n    \"accountType\": 2,\n    \"autoStop\": 0,\n    \"limitPrice\": 0,\n    \"timeInForce\": \"0\",\n    \"isoTimeRestingOrderExpires\": \"2016-01-12T21:00:00.000Z\",\n    \"internalMemo\": \"OGW ACH\",\n    \"amountCash\": 0\n}","language":"json","status":200,"name":"Partial Fill"},{"code":"/*\nA market order is cancelled when:\n\n1. \"orderQty\" is equal to \"leavesQty\".\n2. \"execType\" and \"ordStatus\" are both equal to \"4\".\n*/\n\n{\n    \"orderID\": \"DA.c69f5f51-04ce-4796-a748-67306cdbcb17\",\n    \"accountID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5.1452548617456\",\n    \"userID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"cumQty\": 0,\n    \"accountNo\": \"DWTE000005\",\n    \"commission\": 0,\n    \"createdByID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"createdWhen\": \"2016-01-11T22:01:09.066Z\",\n    \"execType\": \"4\",\n    \"grossTradeAmt\": 0,\n    \"instrumentID\": \"675cc7c2-e24b-42fa-9d1f-4b3a97ae8d2f\",\n    \"lastPx\": 0,\n    \"lastQty\": 0,\n    \"leavesQty\": 3,\n    \"orderNo\": \"DAQB000017\",\n    \"orderQty\": 3,\n    \"ordStatus\": \"4\",\n    \"ordType\": \"1\",\n    \"price\": 0,\n    \"rateAsk\": 0,\n    \"rateBid\": 0,\n    \"side\": \"B\",\n    \"accountType\": 2,\n    \"autoStop\": 0,\n    \"limitPrice\": 0,\n    \"timeInForce\": \"0\",\n    \"isoTimeRestingOrderExpires\": \"2016-01-12T21:00:00.000Z\",\n    \"internalMemo\": \"OGW ACH\",\n    \"amountCash\": 0\n}","language":"json","status":200,"name":"Cancelled"},{"code":"/*\nA market order is rejected when:\n\n1. \"leavestQty\" is equal to \"0\".\n2. \"execType\" and \"ordStatus\" are both equal to \"8\".\n3. \"ordRejReason\" will be present with reason. E.g. \"Non-Margin accounts cannot sell short.\n*/\n\n{\n    \"orderID\": \"DA.c69f5f51-04ce-4796-a748-67306cdbcb17\",\n    \"accountID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5.1452548617456\",\n    \"userID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"cumQty\": 0,\n    \"accountNo\": \"DWTE000005\",\n    \"commission\": 0,\n    \"createdByID\": \"02e57c7d-d071-4c63-b491-1194a9939ea5\",\n    \"createdWhen\": \"2016-01-11T22:01:09.066Z\",\n    \"execType\": \"8\",\n    \"grossTradeAmt\": 0,\n    \"instrumentID\": \"675cc7c2-e24b-42fa-9d1f-4b3a97ae8d2f\",\n    \"lastPx\": 0,\n    \"lastQty\": 0,\n    \"leavesQty\": 0,\n    \"orderNo\": \"DAQB000017\",\n    \"orderQty\": 13,\n    \"ordRejReason\": \"Non-Margin accounts cannot sell short.\",\n    \"ordStatus\": \"8\",\n    \"ordType\": \"1\",\n    \"price\": 0,\n    \"rateAsk\": 0,\n    \"rateBid\": 0,\n    \"side\": \"S\",\n    \"accountType\": 2,\n    \"autoStop\": 0,\n    \"limitPrice\": 0,\n    \"timeInForce\": \"0\",\n    \"isoTimeRestingOrderExpires\": \"2016-01-12T21:00:00.000Z\",\n    \"internalMemo\": \"OGW ACH\",\n    \"amountCash\": 0\n}","language":"json","status":200,"name":"Rejected"}]},"settings":"","auth":"required","params":[{"_id":"56940ce773f48f0d0075c9e0","ref":"","in":"path","required":true,"desc":"Order ID.","default":"DA.5f674a8a-203e-49a3-b474-7bb271c61507","type":"string","name":"orderID"}],"url":"/orders/:orderID"},"isReference":true,"order":3,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Market Order Information Only\",\n  \"body\": \"Even though this endpoint supports three order types (Market, Stop and Limit), this page is just for details on a market order.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Response\"\n}\n[/block]\nEvery market order will return a single order object and have a default list of attributes.\n\n|Attribute|Description|\n|---|---|---|---|\n| `orderID`|Order ID.|\n| `accountID`|User's account ID.|\n| `userID`|User's user ID.|\n| `cumQty`|Cumulative quantity filled.|\n| `accountNo`|Account number.|\n| `comment`|User generated comment.|\n| `commission`|Commission charged (positive value).|\n| `createdByID`|User ID of order.|\n| `createdWhen`|Date/time order was created.|\n| `executedWhen`|Date/time of last trade execution.|\n| `execType`|Execution type: `\"0\"` - New, `\"1\"` - Partial Fill, `\"2\"` - Fill, `\"4\"` - Canceled, `\"8\"` - Rejected.|\n| `grossTradeAmt`|Gross trade amount (excluding commission).|\n| `instrumentID`|Instrument ID.|\n| `leavesQty`|Quantity remaining to be filled.|\n| `orderNo`|Order number.|\n| `orderQty`|Number of shares.|\n| `ordRejReason`| Only displays if the order is rejected.  See [Common Order Gateway Error Codes](doc:common-order-gateway-error-codes) for rejected reason.\n| `ordStatus`|Order status: `\"0\"` - New, `\"1\"` - Partial Fill, `\"2\"` - Fill, `\"4\"` - Canceled, `\"8\"` - Rejected.|\n| `ordType`|Order type: set to `\"1\"`.|\n| `side`|Side of order: `\"B\"` - Buy or `\"S\"` - Sell.|\n| `accountType`|Account type: `\"1\"` - Practice or `\"2\"` - Live.|\n| `autoStop`|Auto stop level. See [Create - Market Order](doc:add-market-order) for more information.|\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Market Order Notes\"\n}\n[/block]\n##### New Market Order\nA market order is successfully accepted when:\n\n1. `orderQty` is equal to `leavesQty`.\n2. `execType` and `ordStatus` are both equal to `\"0\"`.\n\n#### Filled Market Order\nA market order is successfully filled when:\n\n1. `orderQty` is equal to `cumQty`.\n2. `execType` and `ordStatus` are both equal to `\"2\"`.\n\n#### Partially-Filled Market Order\nA market order is partially filled when:\n\n1. `cumQty` is less than `orderQty`.\n2. `execType` and `ordStatus` are both equal to `\"1\"`.\n\n#### Cancelled Market Order\nA market order is cancelled when:\n\n1. `leavesQty` is equal to `\"0\"`.\n2. `execType` and `ordStatus` are both equal to `\"4\"`.\n\n#### Rejected Market Order\nA market order is rejected when:\n\n1. `leavestQty` is equal to `0`.\n2. `execType` and `ordStatus` are both equal to `\"8\"`.\n3. `ordRejReason` will be present with reason. E.g. `\"Non-Margin accounts cannot sell short.\"`","excerpt":"Get the status on a given order.","slug":"get_market","type":"endpoint","title":"Order Status (Market Order)"}

getOrder Status (Market Order)

Get the status on a given order.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

orderID:
required
stringDA.5f674a8a-203e-49a3-b474-7bb271c61507
Order ID.

Examples


Result Format


Documentation

[block:callout] { "type": "info", "title": "Market Order Information Only", "body": "Even though this endpoint supports three order types (Market, Stop and Limit), this page is just for details on a market order." } [/block] [block:api-header] { "type": "basic", "title": "Response" } [/block] Every market order will return a single order object and have a default list of attributes. |Attribute|Description| |---|---|---|---| | `orderID`|Order ID.| | `accountID`|User's account ID.| | `userID`|User's user ID.| | `cumQty`|Cumulative quantity filled.| | `accountNo`|Account number.| | `comment`|User generated comment.| | `commission`|Commission charged (positive value).| | `createdByID`|User ID of order.| | `createdWhen`|Date/time order was created.| | `executedWhen`|Date/time of last trade execution.| | `execType`|Execution type: `"0"` - New, `"1"` - Partial Fill, `"2"` - Fill, `"4"` - Canceled, `"8"` - Rejected.| | `grossTradeAmt`|Gross trade amount (excluding commission).| | `instrumentID`|Instrument ID.| | `leavesQty`|Quantity remaining to be filled.| | `orderNo`|Order number.| | `orderQty`|Number of shares.| | `ordRejReason`| Only displays if the order is rejected. See [Common Order Gateway Error Codes](doc:common-order-gateway-error-codes) for rejected reason. | `ordStatus`|Order status: `"0"` - New, `"1"` - Partial Fill, `"2"` - Fill, `"4"` - Canceled, `"8"` - Rejected.| | `ordType`|Order type: set to `"1"`.| | `side`|Side of order: `"B"` - Buy or `"S"` - Sell.| | `accountType`|Account type: `"1"` - Practice or `"2"` - Live.| | `autoStop`|Auto stop level. See [Create - Market Order](doc:add-market-order) for more information.| [block:api-header] { "type": "basic", "title": "Market Order Notes" } [/block] ##### New Market Order A market order is successfully accepted when: 1. `orderQty` is equal to `leavesQty`. 2. `execType` and `ordStatus` are both equal to `"0"`. #### Filled Market Order A market order is successfully filled when: 1. `orderQty` is equal to `cumQty`. 2. `execType` and `ordStatus` are both equal to `"2"`. #### Partially-Filled Market Order A market order is partially filled when: 1. `cumQty` is less than `orderQty`. 2. `execType` and `ordStatus` are both equal to `"1"`. #### Cancelled Market Order A market order is cancelled when: 1. `leavesQty` is equal to `"0"`. 2. `execType` and `ordStatus` are both equal to `"4"`. #### Rejected Market Order A market order is rejected when: 1. `leavestQty` is equal to `0`. 2. `execType` and `ordStatus` are both equal to `"8"`. 3. `ordRejReason` will be present with reason. E.g. `"Non-Margin accounts cannot sell short."`

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}