# v.2.3.0

**2026-04-29 - Live**

**2026-04-14 - Test Environment**

***

**Added**

**Corporate Actions: SWIFT MT564 Simulator Enhancements**

The MT564 mock endpoint has been extended to support additional simulation capabilities for corporate action announcements, enabling more advanced testing scenarios.

* **Documentation Location:** API REFERENCE → Trading → Corporate Actions
* **Endpoint:** `POST /corporate-actions/swift-mock/publishMT564`
* **Purpose:** Enables more advanced simulation scenarios, including automated processing and enriched event context.
* **New Payload Fields:**
  * `automaticApprove` — triggers automatic approval flow in the simulator
  * `additionalText` — free-text field for enriched event context
  * `postedCash` — simulated cash posting amount
  * `postedShares` — simulated shares posting quantity
* **Note:** These simulation endpoints are intended for testing purposes only and may be subject to change as the simulator evolves.

***

**Changed**

**Ex-Ante API: Price Precision**

The precision of price representation in the Ex-Ante response has been increased to better reflect accurate market pricing.

* **Documentation Location:** API REFERENCE → Trading → Traditional Assets
* **Endpoint:** `POST /traditional/ex-ante`
* **Changed:** `order.pricePerUnit` — now supports up to 3 decimal places (e.g. `1.055`)

***

**Assets API: Regulatory Filtering for US ETFs**

To comply with European regulatory requirements (PRIIPs/KID), certain ETF instruments are no longer returned for retail clients.

* **Documentation Location:** API REFERENCE → Trading → Assets
* **Endpoint:** `GET /assets`
* **Behavior change:** ETFs with ISINs starting with `US` are no longer included in the response payload. This filtering is applied automatically by the backend — no additional query parameters are required.

***

**Tax Engine: US Dividend Tax Withholding Logic**

Automated logic has been introduced to determine the appropriate US dividend withholding tax rate for natural persons based on their submitted tax residency, without requiring new fields in the Partner API.

* **Affected Workflows:** Tax Calculation / Dividend Processing
* **Behavior change:** The system calculates the withholding rate internally based on the `taxResidency.country` array:
  * `0%` — applied if the natural person's only tax residency is the US
  * `15%` — applied if the natural person holds tax residency in one or more qualifying treaty countries (e.g. DE, PL, FR, GB)
  * `30%` — applied if the natural person holds at least one tax residency in a non-treaty country, overriding other residencies


---

# 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.3.0.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.
