API Authorization
Identity & Access Management
Wallets & Transactions
Management
Webhooks
{
"id": "swap-6a3ku-bn8d7-8u5rs1oukojms7k8",
"quoteId": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t",
"reference": null,
"walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
"targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
"status": "PendingPolicyApproval",
"provider": "UniswapClassic",
"quotedSourceAsset": {
"kind": "Native",
"amount": "10000000000",
"metadata": {
"network": "EthereumSepolia",
"name": "Ethereum",
"symbol": "SepoliaETH",
"decimals": 18,
"tid": "native:eth"
}
},
"quotedTargetAsset": {
"kind": "Erc20",
"contract": "0xda0be7efd234295395d4204d0df4358339b57b27",
"amount": "6467571553831928182",
"metadata": {
"network": "EthereumSepolia",
"name": "Test",
"symbol": "Test",
"decimals": 18,
"tid": "erc20:0xda0be7efd234295395d4204d0df4358339b57b27"
}
},
"slippageBps": 100,
"dateCreated": "2025-09-11T10:57:55.758Z",
"requestBody": {
"quoteId": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t",
"walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
"targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
"provider": "UniswapClassic",
"slippageBps": 100,
"sourceAsset": {
"kind": "Native",
"amount": "10000000000"
},
"targetAsset": {
"kind": "Erc20",
"contract": "0xda0be7efd234295395d4204d0df4358339b57b27",
"amount": "653003161"
}
},
"requester": {
"userId": "us-48r5q-eshfg-9pmr2lo6bmpr4i4i",
"tokenId": "to-4etah-smoal-9n3rmhul4dpaueg5"
}
}Dfns supports swapping via multiple providers to let you execute token swaps across supported EVM-chains. Below is an overview of the swap providers, what they are, and which chains each supports.
Flow Overview
- Request a Quote: Retrieve estimated output amounts for a given swap (input token and amount, output token, provider and slippage tolerance).
- Submit the swap intent: Submit a request to Swap, based on the
quoteId - Approve policies: If using Wallet:Sign policies, review the transactions and approve them, due to the nature of a Swap transaction, you might be required to approve up to 4 signatures/transactions.
- Track Status: Monitor the Swap execution.
Swap object
Swap id.
1 - 64^swap-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$"swap-5ch70-fc3n7-3k2cbo8d7q5lnts4"
Id of the quote this swap is based on.
1 - 64^swapQuote-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$"swapQuote-7n9p0-cth75-6l74n2sj7u73ooeq"
Optional user-defined reference for this Swap.
Id of the Dfns wallet spending the sourceAsset.
1 - 64^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$"wa-5pfuu-9euek-h0odgb6snva8ph3k"
Id of the Dfns wallet receiving the target asset. Currently this value must be the same as the walletId.
1 - 64^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$"wa-5pfuu-9euek-h0odgb6snva8ph3k"
Swap status.
PendingPolicyApproval, InProgress, Completed, Failed, Rejected Swap provider.
UniswapX, UniswapClassic The source asset for this swap transaction.
- Native Asset
- EVM Fungible Token (ERC-20)
Show child attributes
Show child attributes
The target asset for this swap transaction.
- Native Asset
- EVM Fungible Token (ERC-20)
Show child attributes
Show child attributes
The slippage tolerance for this trade in basis point (BPS). Slippage tolerance defines the maximum price difference you are willing to accept during a trade from the estimated quote, ensuring you still receive at least a minimum number of tokens if the price shifts. One basis point equals one-hundredth of a percentage point, or 0.01%.
The full request used for initiating this swap.
- Option 1
- Option 2
Show child attributes
Show child attributes
The user who initiated the request.
Show child attributes
Show child attributes
Was this page helpful?