> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amberdata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Upcoming changes to batch endpoints

## 2025-01-08

We are excited to announce upcoming improvements being made to our Batch API endpoints! As part of our commitment to delivering the best developer experience, we will be introducing new versioned Batch endpoints under the `/markets` prefix by the end of March 2025 (or sooner). These changes will provide a more consistent and intuitive URI structure, improved usability, and enhanced scalability.

### What’s Changing?

**New Endpoint Structure**

* The legacy Batch endpoints (e.g., `market/options/open-interest/exchange/{exchange}/historical`) will be replaced by new versioned endpoints using the `/markets` prefix and a streamlined naming convention:
  * **Example**: `market/options/open-interest/exchange/{exchange}/historical` → `/markets/options/batch-open-interest/{exchange}`

**Parameters**

* The new endpoints will support the following parameters (instruments, startDate, endDate, timeInterval, timeFormat) and will remain functional with the following changes:
  * `pair` becomes `instruments`
  * `exchange` is a required path parameter
  * `instruments` is a required parameter
  * The `startDate` and `endDate` parameters cannot retrieve data older than 62 days. Any requests attempting to access data beyond this limit will result in an error. Default behavior will change to return only the previous 62 days of data.
  * `timeInterval` will no longer accept `tick` or `ticks` (only minutes, hours, days)
  * `timeFormat` remains unchanged (keep existing functionality)
  * All new endpoints will use pagination (`next` URL)
  * All new endpoints accept two new headers (same functionality as the other new versioned endpoints):
    * `api-version`
    * `Accept-Encoding`

<br />

### Deprecation Timeline

| Action                      | Date                     |
| :-------------------------- | :----------------------- |
| Announcement of changes     | 2025-01-08               |
| New endpoints available     | 2025-03-31 (*or sooner*) |
| Legacy endpoints deprecated | 2025-06-01               |

We recommend all customers begin migrating to the new endpoints **as soon as they are available** to take full advantage of the enhancements.

<br />

### Affected Endpoints

The following legacy endpoints will be replaced:

| Legacy Endpoint                                               | Future New Endpoint                               |
| :------------------------------------------------------------ | :------------------------------------------------ |
| `market/futures/funding-rates/exchange/{exchange}/historical` | `/markets/futures/batch-funding-rates/{exchange}` |
| `market/futures/ohlcv/exchange/{exchange}/historical`         | `/markets/futures/batch-ohlcv/{exchange}`         |
| `market/futures/open-interest/exchange/{exchange}/historical` | `/markets/futures/batch-open-interest/{exchange}` |
| `market/options/ohlcv/exchange/{exchange}/historical`         | `/markets/options/batch-ohlcv/{exchange}`         |
| `market/options/open-interest/exchange/{exchange}/historical` | `/markets/options/batch-open-interest/{exchange}` |
| `market/spot/ohlcv/exchange/{exchange}/historical`            | `/markets/spot/batch-ohlcv/{exchange}`            |
| `market/swaps/ohlcv/exchange/{exchange}/historical`           | `/markets/futures/batch-ohlcv/{exchange}`         |
| `market/swaps/funding-rates/exchange/{exchange}/historical`   | `/markets/futures/batch-funding-rates/{exchange}` |
| `market/swaps/open-interest/exchange/{exchange}/historical`   | `/markets/futures/batch-open-interest/{exchange}` |

<br />

### What You Need to Do

* Update your API calls to use the new `/markets` endpoints once they are available.
* Review your applications and ensure compatibility with the new endpoint structure.
* Test the new endpoints during the migration period to confirm they meet your requirements.

<br />

### Support

If you have any questions or need assistance during this transition, our support team is here to help. Contact us at [support@amberdata.io](mailto:support@amberdata.io).

Thank you for using our APIs. We are confident these improvements will enhance your experience and look forward to your feedback!