# v.2.2.0

**2026-04-14 - 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](/api-reference/asset-management/corporate-actions.md)
* **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](/api-reference/asset-management/corporate-actions/simulator.md)
* **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](/api-reference/asset-management/wawex-tokenized-assets.md)
* **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](/api-reference/asset-management/corporate-actions.md)
* **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](/api-reference/asset-management/wawex-tokenized-assets.md)
* **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](/api-reference/documents.md)
* **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`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tradevest.ai/release-notes/archive/v.2.2.0-test-environment.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.