Follow these steps to begin your integration with OpenXSwitch:

⚠️ Important:

Webhooks let you receive real-time updates on deposits, withdrawals, and trades.

In your Dashboard, navigate to Webhooks
Add your webhook URL
By default, webhooks are in Sandbox mode for testing and development. Switch to Live mode when ready to receive Live events.
Test it with sandbox events

👉 See Webhook Setup for more details.

The first step in working with our API is to fetch the list of supported rechargeable currencies

✅ You’ll use this coin + chain information in other endpoints such as deposits, withdrawals, and instant-swap.

Use the sandbox for all testing:

https://api.openxswitch.com/v1/sandbox/...

Here you can simulate deposits, withdrawals, instant-swap, and transfers.

⚠️ Important Note on Trial/Sandbox Dashboard Access

When using the dashboard in trial mode (sandbox access):

You cannot generate real deposit addresses, make transfers, or deposit funds through the dashboard.
You can only perform sandbox testing via the API.
All other dashboard services remain available, except Wallet-as-a-Service (WaaS) features.

To use Instant Swap or Trading APIs, you first need to enable trading on a wallet/sub-wallet.

You have two options for activating a sub-wallet:

During creation – use the canTrade property when creating a sub-wallet to enable trading immediately.
After creation – use the Activate Trade Endpoint to enable trading for an existing sub-wallet.

Note: For Prime Wallet, trading must be activated manually;

When ready for production:

Generate a Live API key in your dashboard (sandbox keys will not work in live).
Simply remove /sandbox/ from the URL
Example:
- Sandbox → https://api.openxswitch.com/v1/sandbox/...
- Live → https://api.openxswitch.com/v1/...

Use our CDN service to display asset icons or SVGs in your app

https://cdn.openxswitch.com/public/logos/svg/{coin}.svg

Example:

https://cdn.openxswitch.com/public/logos/svg/usdc.svg

If you haven’t onboarded yet: