diff --git a/content/wallets/pages/transactions/swap-tokens/client.mdx b/content/wallets/pages/transactions/swap-tokens/client.mdx
index 7d80b8dbc..a1aff1af9 100644
--- a/content/wallets/pages/transactions/swap-tokens/client.mdx
+++ b/content/wallets/pages/transactions/swap-tokens/client.mdx
@@ -6,6 +6,7 @@ You need the following environment variables:
 
 <CodeBlocks>
   ```ts title="requestQuote.ts"
+  import { parseUnits } from "viem";
   import { swapActions } from "@alchemy/wallet-apis/experimental";
   import { client } from "./client";
 
@@ -16,7 +17,7 @@ You need the following environment variables:
   const { quote, ...calls } = await swapClient.requestQuoteV0({
     fromToken: "0x...",
     toToken: "0x...",
-    minimumToAmount: "0x...",
+    minimumToAmount: parseUnits("1", 6), // decimals must match toToken (e.g. 6 for USDC, 18 for ETH)
   });
 
   // Display the swap quote, including the minimum amount to receive and the expiry
diff --git a/content/wallets/pages/transactions/swap-tokens/index.mdx b/content/wallets/pages/transactions/swap-tokens/index.mdx
index 61ce864be..8f2bb6f91 100644
--- a/content/wallets/pages/transactions/swap-tokens/index.mdx
+++ b/content/wallets/pages/transactions/swap-tokens/index.mdx
@@ -31,15 +31,17 @@ Swaps work like any other Smart Wallet transaction, so you can sponsor gas for g
 When requesting a swap quote, specify either an amount in, or a minimum amount out.
 
 ```tsx
+import { parseUnits } from "viem";
+
 // Mode 1: Swap exact input amount
 {
-  fromAmount: "0x2710";
-} // Swap exactly 0.01 USDC (10000 in hex, 6 decimals)
+  fromAmount: parseUnits("0.01", 6);
+} // Swap exactly 0.01 USDC (6 decimals)
 
 // Mode 2: Get minimum output amount
 {
-  minimumToAmount: "0x5AF3107A4000";
-} // Get at least 0.0001 ETH (18 decimals). We calculate how much USDC you need to spend to get at least your desired ETH amount.
+  minimumToAmount: parseUnits("1", 6);
+} // Get at least 1 USDC. Decimals must match toToken (e.g. 6 for USDC, 18 for ETH). We calculate how much you need to spend to receive at least your desired amount.
 ```
 
 ## Prerequisites
@@ -76,10 +78,11 @@ Currently, the Swap API supports only single-chain swaps. Cross-chain swaps are
 
 ## How do you encode values?
 
-Values are passed as hexadecimal strings. The Swap API does not add complexity to consider decimals, so 0x01 is always the smallest amount of a given asset.
+**JavaScript SDK**: amounts are passed as `bigint` values. For example, 1 ETH is `1_000_000_000_000_000_000n` and 1 USDC is `1_000_000n`.
+
+**Raw API**: values are passed as hexadecimal strings. The Swap API does not add complexity to consider decimals, so `0x01` is always the smallest amount of a given asset.
 1 ETH, or DAI (18 decimals) is `0xDE0B6B3A7640000`
 1 USDC (6 decimals) is `0xF4240`
-This removes any ambiguity— if it’s numerical, it’s a hex.
 
 ## What is the expiry?