This procedure requires integration credentials, a funded test wallet, and trusted deployment configuration. The example endpoint uses test networks. This procedure describes a cross-chain OIF order. For a same-chain request, use the same-chain swap flow.

1. Discover a route

Select chain domains and asset keys from the response. Check the source and destination capabilities separately.

2. Request a quote

Create quote-request.json with values from the catalog and the user’s request. Use decimal strings for amounts in base units.

3. Validate and authorize

Validate the returned executable payload against the request and trusted contract addresses. Display the exact input, minimum output, recipient, fees, and expiry. Use the authorization mechanism selected by the quote. Do not sign a preview response.

4. Submit or register

Use POST /order/openfor for OIF execution and wallet-paid OIF registration. Include the required signature only for a signed execution mechanism. Register a Solana wallet plan before broadcasting its transactions. Preserve the returned order identifiers and every wallet transaction hash.

5. Track delivery and settlement

Read upstream status with the returned upstream identifier or hubOrderId. Read chain observations with onchainOrderId. Track destination delivery separately from origin settlement. Apply submission recovery if the response is lost.