Ctrlk
tradevest.ai

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

Last updated