Events

OpenXSwitch - Webhook Events

OpenXSwitch provides webhook notifications for various flows, including withdrawal, deposit, and internal transfers. Each flow consists of parent methods with specific sub-methods that represent the status or progress of the event. These webhooks ensure real-time updates to your application for key activities.

Supported Webhook Events

• Deposit
• Withdrawal
• Internal Transfer
• Instant Swap
• Trade

Best Practices

1. Idempotent Processing: Ensure your webhook handlers are idempotent to avoid duplicate processing.
2. Balance Handling: Avoid increment/decrement logic. Use the full asset or assets data from our webhook payload to update balances directly. Our ledger ensures accurate values across wallets and sub-wallets.
3. Final Events Only: Update balances only on final events, Refer to the full list of supported events to identify valid final event types.
4. Acknowledgment: Always respond with a 2xx HTTP status code within 1 minutes to acknowledge receipt.
5. Security: Verify webhook payload signatures to ensure authenticity.