--- title: "Changes to Retrieve current orders on Smarkets, these include open and recently settled orders." method: GET path: "/v3/orders/" --- # Changes to Retrieve current orders on Smarkets, these include open and recently settled orders. `GET /v3/orders/` > Every recorded change to this operation, newest first. > 21 revisions in range; 1 not diffed. ## Timeline Changed in 5 of 21 revisions. - **2026-09-01** `75f7e3050340`: 5 info - **2025-09-20** `9912a2182e61`: 1 breaking - **2024-08-26** `e605dcddbcbe`: 1 warning, 4 info - **2022-10-22** `a17ca5bb986a`: 1 warning, 1 info - **2022-02-06** `032833ac8ca3`: 6 breaking, 5 warning, 290 info ## Changes - **2026-09-01** `75f7e3050340`: 5 info - added the new optional `query` request parameter `include_promotion_data` - added the optional property `orders/items/otc_available` to the response with the `200` status - added the optional property `orders/items/token_used/original_price` to the response with the `200` status - added the optional property `otc_available` to the response with the `200` status - added the required property `orders/items/average_price_matched_precise` to the response with the `200` status - **2025-09-20** `9912a2182e61`: 1 breaking - the `orders/items/token_used/boost_percent` response's property type changed from `integer` to `number` for status `200` - **2024-08-26** `e605dcddbcbe`: 1 warning, 4 info - added the new `PROMOTION_SERVICE_UNAVAILABLE` enum value to the `error_type` response property for the response status `503` - added the optional property `orders/items/best_price` to the response with the `200` status - added the required property `orders/items/quantity_traded_out_user_currency` to the response with the `200` status - added the required property `orders/items/stake_traded_out_user_currency` to the response with the `200` status - added the required property `orders/items/token_used` to the response with the `200` status - **2022-10-22** `a17ca5bb986a`: 1 warning, 1 info - added the new `over_the_counter_free` enum value to the `orders/items/type` response property for the response status `200` - added the optional property `orders/items/bonus_bet` to the response with the `200` status - **2022-02-06** `032833ac8ca3`: 6 breaking, 5 warning, 290 info - the response's body type changed from `object` to no type for status `400` - the response property `orders/items/label` became nullable for the status `200` - the response property `orders/items/outcome` became nullable for the status `200` - the response property `pagination/next_page` became nullable for the status `200` - the `data` response's property type changed from `null` to `object` for status `500` - the `data` response's property type changed from `string` to `string, object` for status `400` - added the new `deadheat` enum value to the `orders/items/outcome` response property for the response status `200` - added the new `loser` enum value to the `orders/items/outcome` response property for the response status `200` - added the new `reduce` enum value to the `orders/items/outcome` response property for the response status `200` - added the new `void` enum value to the `orders/items/outcome` response property for the response status `200` - added the new `winner` enum value to the `orders/items/outcome` response property for the response status `200` - added the non-success response with the status `401` - added the non-success response with the status `403` - added the non-success response with the status `503` - added the non-success response with the status `504` - removed the `1.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `10.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `100.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1000.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1020.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1042.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `105.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1064.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1087.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `111.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1111.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1136.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1163.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `118.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1190.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1220.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `125.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1250.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1282.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1316.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `133.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1351.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1389.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `1429.00` enum value from the `orders/items/price` response property for the response status `200` - removed the `143.00` enum value from the `orders/items/price` response property for the response status `200` - …261 more --- [Operation](https://skmtc.dev/smarkets/apis/smarkets-http-api/docs/v3/orders/get.md) - [API](https://skmtc.dev/smarkets/apis/smarkets-http-api.md) - [Page](https://skmtc.dev/smarkets/apis/smarkets-http-api/changes/v3/orders/get)