v27.0.0

Changelog

2026-08-18

Breaking Change

Java SDK async methods no longer declare throws

Products:

Scope: Java-SDK

• What's new
  Asynchronous Java SDK methods no longer declare a checked exception that can never be thrown; call failures continue to arrive through the returned future.

• Impact
  Code that wraps a Java SDK call in a try/catch for the API exception will stop compiling until that unreachable catch block is removed.

Affected endpoints:

Fix Travel Rule legalPerson name schema for IVMS101 compliance

Products: Off exchanges, Transactions, Travel Rule

Scope: API + SDKs

• What's new
  Fixes the Travel Rule legal person name schema to use the IVMS101-compliant array structure with proper name type codes (LEGL, SHRT, TRAD) instead of the incorrect flat object format.

• Impact
  Customers must update Travel Rule integrations to use the new array-based name identifier structure.

Affected endpoints:

1. Validate Full Travel Rule Transaction
2. Create a new transaction
3. Estimate transaction fee
4. Add Collateral
5. Remove Collateral

Fix Travel Rule legalPerson name schema for IVMS101 compliance

Products: Travel Rule

Scope: API + SDKs

• What's new
  Fixes the Travel Rule legal person name schema to use the IVMS101-compliant array structure with proper name type codes (LEGL, SHRT, TRAD) instead of the incorrect flat object format.

• Impact
  Customers must update Travel Rule integrations to use the new array-based name identifier structure.

Affected endpoints:

1. Validate Full Travel Rule Transaction

Added

Add ETH staking consolidation and withdrawal ETA fields

Products: Staking

Scope: API + SDKs

• What's new
  Adds three new optional fields to EthereumBlockchainData: estimatedSourceExitTime, estimatedConsolidationTime, and estimatedWithdrawalTime to surface timing estimates for in-flight ETH validator consolidations and withdrawals.

• Impact
  Customers can now track estimated completion times for pending ETH staking consolidations and withdrawals via the API.

Affected endpoints:

1. Get position details
2. List staking positions
3. List staking positions (Paginated)

Add gaslessInfo to transaction responses

Products: Transactions

Scope: API + SDKs

• What's new
  Adds a new gaslessInfo object to transaction responses containing relay and meta-transaction details including tenant and vault account information.

• Impact
  Customers can identify meta-transactions and see which relay tenant sponsored the gas fees.

Affected endpoints:

1. Get a specific transaction by external transaction ID
2. Get a specific transaction by Fireblocks transaction ID
3. Get transaction history

Add new ReasonForPaymentEnum values

Products: Trading (Beta)

Scope: API + SDKs

• What's new
  Adds three new payment reason values: CORPORATE_INVESTMENT, INTER_COMPANY_TRANSFER, and OFFICE_OPERATING_EXPENSES to support additional corporate payment use cases.

• Impact
  Customers can now specify additional payment reasons when creating trading orders.

Affected endpoints:

1. Create an order

Add FSPM security findings endpoint

Products: Security Posture Management

Scope: API + SDKs

• What's new
  Adds an endpoint to retrieve paginated security posture findings for a workspace, with filtering by severity, category, and status.

• Impact
  Customers with Security Admin or Security Auditor roles can programmatically retrieve security posture findings.

Affected endpoints:

1. Get FSPM security findings

Fixed

Document Owner and Viewer roles for staking endpoints

Products: Staking

Scope: API + SDKs

• What's new
  Adds missing Owner and Viewer roles to endpoint permission documentation for staking list endpoints. These roles were already permitted at runtime but not documented.

• Impact
  Customers with Owner or Viewer roles now see accurate permission documentation for staking endpoints.

Affected endpoints:

1. List staking positions
2. List staking positions (Paginated)
3. List staking providers

---