# v.2.2.0 - Test Environment

**2026-04-14 - Planned deployment to Live**

**2026-03-31 - Test Environment**

***

**Added**

**Corporate Actions: Webhook Notifications**

We have added new fields to the corporate action webhook payload to support enhanced ratio representation and a new status.

* **Webhook:** `CORPORATE_ACTION_NOTIFICATION`
* **Purpose:** Enhances the webhook payload to support the new two-field ratio representation and introduces a new pending state.
* **Payload Changes:**
  * **Added:** `details.ratioFrom`, `details.ratioTo`, `accounts[].eligibleQuantity`, `accounts[].ratioFrom`, `accounts[].ratioTo`.
  * **Added:** `PENDING` to the `status` enum.

**Corporate Actions: Retrieval Endpoints**

We have expanded our corporate action endpoints with new query parameters and response fields.

* **Documentation Location:** [Corporate Actions](https://docs.tradevest.ai/release-notes/broken-reference)
* **Endpoints:**
  * `GET /corporate-actions/`
  * `GET /corporate-actions/customers/{customerId}`
* **Purpose:** Provides extended filtering capabilities and enriched corporate action details for customer-specific context, including extended tender option details.
* **Payload Changes:**
  * **Added:** Query parameters `exDate`, `paymentDate`, `recordDate`, `responseDeadline`, `status` (applicable to `GET /corporate-actions/`).
  * **Added:** Response fields `status`, `details.ratioFrom`, `details.ratioTo`, `details.corporateActionOptions[].maximumCashAmount`, `details.corporateActionOptions[].creditedIsin`, `details.corporateActionOptions[].exchangeRatio`, `customer.ratioFrom`, `customer.ratioTo`.

**Corporate Actions: SWIFT Simulator Endpoints**

We have added new ratio and tender option fields to the payload of our SWIFT mock simulation endpoints. *(Note: These simulation endpoints are subject to change as the simulator evolves).*

* **Documentation Location:** [Simulator](https://docs.tradevest.ai/release-notes/broken-reference)
* **Endpoints:**
  * `POST /corporate-actions/swift-mock/publishMT564`
  * `POST /corporate-actions/swift-mock/publishMT566`
* **Purpose:** Enables simulation of MT564 (announcement) and MT566 (confirmation) messages utilizing the extended ratio and tender option structures.
* **Payload Changes:**
  * **Added:** `ratioFrom` and `ratioTo` to both endpoints.
  * **Added:** `tenderOptions[].maximumCashAmount`, `tenderOptions[].creditedIsin`, `tenderOptions[].exchangeRatio` to the MT564 endpoint.

**WAWEX Tokenized Trading: Assets Endpoint**

We have extended the WAWEX assets endpoint to provide deeper insights into tokenized instruments.

* **Documentation Location:** [WAWEX Tokenized Assets](https://docs.tradevest.ai/release-notes/broken-reference)
* **Endpoint:** `GET /wawex/assets`
* **Purpose:** Extends the asset retrieval payload to include risk scoring, underlying ISIN relationships, and global asset counts.
* **Payload Changes:**
  * **Added:** Query parameter to filter by `symbol` OR `assetName`.
  * **Added:** Response fields `underlyingISIN`, `assetRiskScore`, `totalNumberOfAssets`.
  * **Added:** Enum value `Tracker_Certificate` to the `assetType` field.

***

**Changed**

**Corporate Actions: Ratio Representation Refactor**

We have updated how corporate action ratios are represented across the platform.

* **Documentation Location:** [Corporate Actions](https://docs.tradevest.ai/release-notes/broken-reference)
* **Endpoints:** Applies to all Corporate Action endpoints and webhooks.
* **Purpose:** Improves clarity and consistency for representing corporate action ratios (e.g., splits, bonus issues, exchanges) by transitioning from single-field indicators to a strictly defined two-field representation (`ratioFrom` and `ratioTo`).

**Corporate Actions: Endpoint Naming Updates**

Endpoint titles in the API documentation have been updated for better contextual accuracy.

* **Endpoints:**
  * `GET /corporate-actions/` renamed to **Get Corporate Actions for Customer**.
  * `GET /corporate-actions/customers/{customerId}` renamed to **Get Corporate Actions by Customer**.

**WAWEX Tokenized Trading: Order Contract Alignment**

We have aligned the WAWEX tokenized order response model directly with the Traditional Order contract.

* **Documentation Location:** [Tokenized Trading](https://docs.tradevest.ai/release-notes/broken-reference)
* **Endpoint:** `GET /wawex/orders/{orderId}`
* **Purpose:** Reduces partner-specific mapping efforts and ensures structural consistency across trading domains by strictly matching the Traditional Order shape.
* **Payload Changes:**
  * Top-level fields and `partialExecutions[]` array now match the Traditional Order structure.
  * Replaced `isin` with `symbol`.
  * Replaced `depositoryCustomerProductId` with `walletCustomerProductId`.
  * `orderType` is now strictly set to `MARKET`.
  * **Added:** `exAnteId`, `exchangeCode` (`TVM`), and venue name (`Tradevest Markets`).

**Onboarding: Document Download Performance**

* **Documentation Location:** [Documents](https://docs.tradevest.ai/release-notes/broken-reference)
* **Purpose:** Improves backend retrieval speeds for downloading legal documents.
* **Impact:** Optimized file download speeds for the `Privacy Policy` and `Terms and Conditions` documents during both Natural Person (NP) and Legal Entity (LE) onboarding workflows.

***

**Removed**

**Corporate Actions: Deprecated Ratio Fields**

We have removed legacy single-field ratio data in favor of the new two-field standard (`ratioFrom` and `ratioTo`).

* **Partner Webhook: Corporate Action Notification**
  * Removed fields: `details.bonusRatio`, `details.splitRatio`, `accounts[].bonusRatio`, `accounts[].splitRatio`
* **Endpoint:** `POST /corporate-actions/swift-mock/publishMT564`
  * Removed fields: `splitRatio`, `bonusRatio`
* **Endpoint:** `POST /corporate-actions/swift-mock/publishMT566`
  * Removed fields: `splitRatio`, `bonusRatio`
* **Endpoint:** `GET /corporate-actions/`
  * Removed response fields: `details.bonusRatio`, `details.splitRatio`, `customer.bonusRatio`, `customer.splitRatio`
* **Endpoint:** `GET /corporate-actions/customers/{customerId}`
  * Removed response fields: `details.bonusRatio`, `details.splitRatio`, `customer.bonusRatio`, `customer.splitRatio`

**WAWEX Tokenized Trading: Deprecated Fields & Asset Types**

Redundant structures and unsupported asset types have been removed as part of the Traditional Order contract alignment.

* **Endpoints:**
  * `GET /wawex/orders/{orderId}`
  * `GET /wawex/assets`
* **Purpose:** Cleans up legacy structures and unsupported tokenized asset types.
* **Payload Changes:**
  * **Removed:** `marketOrderData` and `executionData` structures from `GET /wawex/orders/{orderId}`.
  * **Removed:** `CRYPTOCURRENCY` and `SECURITYTOKEN` enum values from the `assetType` field in `GET /wawex/assets`.