search
tradevest.ai

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

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

Last updated