# XBID Orders v1

The XBID Orders v1 will be used for managing orders for XBID. This API will also function
in case of a disconnection of XBID.

> **Be aware:** In case the XBID connection gets lost. The new orders which are created
  with the XBID order API will be automatically forwarded to the local intraday orderbook.
  You can use the XBID Status API for the current connection of XBID.


## Get Order

 - [GET /public-api/1.0/xbid/electricity/orders/{id}](https://api-reference.etpa.nl/api/xbid-orders-v1/getorder_2.md): This API will get you a specific order from the Orderbook. You must use the ETPA
order id and not the XBID order id.

## Update Order

 - [PUT /public-api/1.0/xbid/electricity/orders/{id}](https://api-reference.etpa.nl/api/xbid-orders-v1/putorder_1.md): Updates existing order.
When creating a new order, a regular user has 2 options:
- Creating a buy order
- Creating a sell order

Brokers have the ability to create a direct trade. This enables the broker to do trades between it's own clients.

## Cancel Order

 - [DELETE /public-api/1.0/xbid/electricity/orders/{id}](https://api-reference.etpa.nl/api/xbid-orders-v1/cancelorder_2.md): Cancel order by ETPA ID.

## Get Orders

 - [GET /public-api/1.0/xbid/electricity/orders](https://api-reference.etpa.nl/api/xbid-orders-v1/getorders_2.md): With the GET request you can retrieve all the orders which are currently in the
orderbook. This will display both your own orders, but also the orders from other
exchanges.

Orders can be filtered on the selected delivery start time, on delivery end time, on participantId, on own orders or not with the my-parameter.

## Create Order

 - [POST /public-api/1.0/xbid/electricity/orders](https://api-reference.etpa.nl/api/xbid-orders-v1/postorder_1.md): Creates new order.
When creating a new order, there are 2 options:
- Creating a buy order
- Creating a sell order

## Cancel all orders

 - [DELETE /public-api/1.0/xbid/electricity/orders](https://api-reference.etpa.nl/api/xbid-orders-v1/deleteallorders.md): Cancel all user orders

## Create Basket Order

 - [POST /public-api/1.0/xbid/electricity/orders/basket](https://api-reference.etpa.nl/api/xbid-orders-v1/handlebasketorderrequest.md): Creates new basket order.
When creating a new basket order, you must select the Execution Type
- "NONE": All orders in the order list are executed individually.
- "VALID": All orders must be valid orders. If 1 order is invalid, none of the orders are executed.
- "LINKED": All orders in the order list must be matched immediately. If 1 order does not match immediately, all orders in the order list are canceled.

## Get Orders By Quarters

 - [GET /public-api/1.0/xbid/electricity/orders/quarter](https://api-reference.etpa.nl/api/xbid-orders-v1/getquartersorderslist.md): Get orders filtered on quarters interval. Please provide Date in this format yyyy-mm-dd

## Get Orders By Hours

 - [GET /public-api/1.0/xbid/electricity/orders/hour](https://api-reference.etpa.nl/api/xbid-orders-v1/gethoursorderslist.md): Get orders filtered on hourly interval. Please provide Date in this format yyyy-mm-dd

## Get Orders By Half Hours

 - [GET /public-api/1.0/xbid/electricity/orders/half-hour](https://api-reference.etpa.nl/api/xbid-orders-v1/gethalfhoursorderslist.md): Get orders filtered on half hours interval. Please provide Date in this format yyyy-mm-dd