# ETPA XBID Public API

Version: 2.0.0

## Servers

```
https://acc-trading.etpa.nl
```

## Security

### api-key

Type: apiKey
In: header
Name: api_key

## Download OpenAPI description

[ETPA XBID Public API](https://api-reference.etpa.nl/_bundle/public-xbid-trades.yaml)

## XBID Public Trades v1

### Get all public XBID trades

 - [GET /public-api/1.0/xbid/public-trades](https://api-reference.etpa.nl/public-xbid-trades/xbid-public-trades-v1/getallxbidtrades.md): Get all public XBID trades which can be filtered and paged.

  Constraints:
    - If no content is found for the provided parameters, the request  will return a 204 No Content.
    - If the system is unavailable, the request will return a BAD REQUEST response.`.

### Get Recent Public XBID Trades

 - [GET /public-api/1.0/xbid/public-trades/recent](https://api-reference.etpa.nl/public-xbid-trades/xbid-public-trades-v1/getrecenttrades_1.md): The recent Public XBID trades API will return all the trades of the last 2 days.

Constraints:
    - If the system is unavailable, the request will return a BAD REQUEST response.

## XBID Public Trades v2

### Get all public XBID trades

 - [GET /public-api/2.0/xbid/public-trades/{deliveryAreaId}](https://api-reference.etpa.nl/public-xbid-trades/xbid-public-trades-v2/getrecenttrades.md): Get all public XBID trades. This endpoint can filter and page the results.

 Constraints:
    - If the system is unavailable, the request will return a BAD REQUEST response.`.

### Get Historical public XBID trades

 - [GET /public-api/2.0/xbid/public-trades/history](https://api-reference.etpa.nl/public-xbid-trades/xbid-public-trades-v2/gethistoricaltrades.md): Retrieve historical public trades within a specified time range.
This endpoint is suitable when needing historical trade data in within controlled time ranges without overloading ETPA's system

Constraints:

- The difference between end and start must not exceed 6 hours.

- If the requested time interval is too wide, an 400 error will be thrown.

- If the system is unavailable, the request will return a BAD REQUEST response.