Instant Swap Event

This webhook is fired when an instant swap has been create and completed successfully.

Parent Method: instant_swap
Sub-Methods:
- completed: Triggered when the internal transfer is successfully processed.

Example Payload for Instant Swap:

{
  "requestId": "ab67d4be56d4d549f59b92a17fd71b",
  "method": "instant_swap.completed",
  "params": {
    "id": "68180c09b19304fc881991c2",
    "fee": 0,
    "fromCoin": "USDT",
    "fromAmount": 2,
    "toCoin": "TRX",
    "toAmount": 7.55102795,
    "swapPrice": 3.77551398,
    "status": "success",
    "ts": "1746918883356",
    "quoteId": "1305237885725507584",
    "walletId": "6812c4977de20fb535e5bdee",
    "workspaceId": "656abf1e4b5f5e0012345678",
    "createdAt": "2025-05-04T23:58:20.494Z",
    "wallet": {
      "id": "6812b103908d2d0d49c7ff79",
      "clientUserId": null,
      "email": "email@openxswitch.com",
      "name": "openxswitch-subwallet",
      "assets":[ 
          {
            "coin": "USDT",
            "balance": 9,
            "frozen": 0,
            "updatedAt": "2025-05-04T23:58:20.494Z"
          },
          {
            "coin": "TRX",
            "balance": 26.043,
            "frozen": 0,
            "updatedAt": "2025-05-04T23:58:20.494Z"
          }
      ],
      "isSubWallet": false
    }
  }
}

Reference

Field	Description	Type
`requestId`	Unique identifier for the webhook event	`string`
`method`	Name of the webhook method	`string`
`params.fee`	Swap fee charged for the transaction	`number`
`params.fromCoin`	The coin swapped from (input coin)	`string`
`params.fromAmount`	The amount of `fromCoin` used in the swap	`number`
`params.toCoin`	The coin swapped to (output coin)	`string`
`params.toAmount`	The amount of `toCoin` received from the swap	`number`
`params.swapPrice`	Effective price of the swap (toAmount / fromAmount)	`number`
`params.ts`	Timestamp of the swap event (likely in milliseconds since epoch)	`string` (or `number`)
`params.quoteId`	Unique identifier for the swap quote used	`string`
`params.walletId`	ID of the wallet involved in the transaction	`string`
`params.workspaceId`	ID of the associated workspace or organization	`string`
`params.createdAt`	Timestamp when the transfer was created	`string` (ISO datetime)
`params.wallet.id`	Wallet ID (redundant with `walletId`, likely the master wallet ID)	`string`
`params.wallet.clientUserId`	Optional external user identifier for the wallet	`string` or `null`
`params.wallet.email`	Email address associated with the wallet	`string`
`params.wallet.name`	Display name of the wallet	`string`
`params.wallet.assets`	List of assets and their balances after the swap	`array of objects`
`params.wallet.assets[].coin`	Coin symbol (e.g., USDT, TRX)	`string`
`params.wallet.assets[].balance`	Balance of the coin after the swap	`number`
`params.wallet.assets[].frozen`	Frozen amount of the coin (if any)	`number`
`params.wallet.assets[].updatedAt`	Last update time of the asset balance	`string` (ISO datetime)
`params.wallet.isSubWallet`	Whether the wallet is a subwallet	`boolean`