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
• 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
• 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
• 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
• 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
• 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
• 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.