# TradePolaris Data API contract changelog

- Current contract: 1.0.0-beta.1
- Status: beta
- Human changelog: https://tradepolaris.com/data-api/changelog
- Machine-readable JSON: https://tradepolaris.com/data-api/changelog.json

## Change categories

- **additive**: A new optional field, parameter, operation, media type, or other backwards-compatible capability.
- **clarification**: Documentation or examples become more precise without changing request or response behavior.
- **deprecated**: An existing operation or field remains available but gains explicit replacement and announcement metadata.
- **breaking**: A removal, rename, new requirement, narrowed input, or incompatible response change that requires a new contract version.

## Deprecation publication

No current operation is deprecated. If a future operation is deprecated, its entry records the announcement date, optional replacement, and an explicit sunset date only when one has actually been selected. OpenAPI marks only the affected operation. Runtime Deprecation and Sunset headers appear only after the corresponding server behavior exists.

## Releases

## 1.0.0-beta.1 — Initial versioned public contract

- Published: 2026-08-21
- Status: beta
- Category: additive
- Contract SHA-256: `77eba320e8e2eb1676f3b244ac596bd08bedcbb99adf1389353bc15264a1500b`

Published the reviewed five-operation read-only contract with one explicit beta version and lifecycle metadata.

- Pinned catalog, preview, schema, structured query, and versioned export as the complete public operation inventory.
- Published consistent HTML, Markdown, OpenAPI 3.1, and machine-readable contract discovery paths.
- Defined additive, clarification, deprecated, and breaking change categories without marking any current operation deprecated.

No operation is deprecated in this version.