Request price streams for trades that deliver digital assets directly to third-party beneficiary wallets instead of your Zodia Markets account.

The price channel works identically to standard price streams, but requires two additional fields to specify the destination.

Prerequisites

Before requesting third-party settlement prices:

Beneficiary Setup

Beneficiaries must be configured:

Complete beneficiary onboarding and verification either via Customer Portal or your Relationship Manager.

Each destination wallet address must be:

Added to the beneficiary's wallet list
Verified through Zodia Markets compliance process
Enabled and active for trading

3. Network Configuration

Ensure the settlement network type is available for your account:

ZM_TRANSFER is the default for crypto settlement
Contact your Relationship Manager for additional network options

⚠️
Important
Orders will be rejected if:

Beneficiary ID is not found or not approved

The Beneficiary does not have a valid Wallet Address for the chosen asset or it is not whitelisted or enabled

Network ID is invalid for your account

How It Differs from Standard Price Subscriptions

Third Party Settlement Price Subscription

{
    "messageType": "subscribe",
    "instrument": "USDT.USD",
    "quantity": "500000",
    "currency": "USD",
    "accountGrpUuid": "a6898bdd-856b-4259-b6e2-6ef66f2282e1",
    "tenor": "T",
    "beneficiaryId": "82876217-7a20-41ca-a474-1e54c0f9459e",
    "networkId": "ZM_TRANSFER"
}

Key differences:

✅ Add beneficiaryId field
✅ Add networkId field
✅ Everything else remains identical

Additional Request Fields

Add these fields to your standard price subscription request:

Field	Required	Type	Description
`beneficiaryId`	No	String	UUID of pre-configured beneficiary. Get Beneficiaries on how to retrieve list of beneficiary UUID
`networkId`	No	String	Settlement network identifier. Default: `ZM_TRANSFER`

All other fields remain the same as standard price subscriptions →.

Responses

All response messages remain identical to standard price streams:

Price updates do not include beneficiary or network information. Use the quoteId to execute orders which will reference your subscription's beneficiary configuration.

Executing Orders with Third Party Settlement

When you execute an order on a third-party settlement price stream, the asset will be delivered to the specified beneficiary's wallet.

{
    "messageType": "order",
    "quoteId": "YdB4DodjOC5FkBDrYmKLW/Dwnz+x9bVbXyshrwz8yntjA+kZAbSAfeCiHba7GBorgzh61EJP2FOf+81m",
    "side": "BUY",
    "clientRequestId": "TESTREQUEST1",
    "accountGrpUuid": "7687282f-1073-441b-9ff4-694e6b49effe"
}

📘
Automatic Beneficiary Association
The quoteId is tied to your subscription, which includes the beneficiaryId and networkId. You don't need to specify beneficiary details in the order request.

Error Handling

Beneficiary Not Found

Causes:

Invalid beneficiary UUID
Beneficiary not configured for your account
Beneficiary not yet approved

Beneficiary Wallet Not Found

Causes:

No wallet address configured for this beneficiary
Wallet not whitelisted for the requested asset
No wallet address configured for this asset
Wallet disabled or pending approval

Invalid Network ID

Cause: Network ID not available for your account

Solution: Contact your Relationship Manager to enable additional network types

Comparison: Standard vs Third Party Settlement

Aspect	Standard Settlement	Third Party Settlement
Asset destination	Your Zodia Markets account and delivery to your named wallet	Beneficiary's wallet
Subscription fields	Standard fields only	`beneficiaryId` + `networkId`
Setup required	None	Beneficiary and wallet configuration
Price updates	Identical	Identical
Order execution	Identical format	Identical format
Settlement time	Standard T+0 or T+1	Standard T+0 or T+1