Swaps - DFNS documentation

{
  "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"
  }
}

See an introduction including the list of supported providers on the swap feature page.

Swap providers require a Terms and Conditions acceptance, which can be done programatically using the Agreement endpoints.

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

string

required

Swap id.

Required string length: 1 - 64

Pattern: ^swap-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"swap-5ch70-fc3n7-3k2cbo8d7q5lnts4"

quoteId

string

required

Id of the quote this swap is based on.

Required string length: 1 - 64

Pattern: ^swapQuote-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"swapQuote-7n9p0-cth75-6l74n2sj7u73ooeq"

reference

string | null

required

Optional user-defined reference for this Swap.

walletId

string

required

Id of the DFNS wallet spending the sourceAsset.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

targetWalletId

string

required

Id of the DFNS wallet receiving the target asset. Currently this value must be the same as the walletId.

Required string length: 1 - 64

Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

status

enum<string>

required

Swap status.

Available options:

PendingPolicyApproval,

InProgress,

Completed,

Failed,

Rejected

provider

enum<string>

required

Swap provider.

Available options:

UniswapX,

UniswapClassic

quotedSourceAsset

Native Asset · object

required

The source asset for this swap transaction.

Native Asset
EVM Fungible Token (ERC-20)

Show child attributes

quotedTargetAsset

Native Asset · object

required

The target asset for this swap transaction.

Native Asset
EVM Fungible Token (ERC-20)

Show child attributes

slippageBps

number

required

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%.

dateCreated

string<date-time>

required

ISO 8601 date (must be UTC). When the swap was initiated.

requestBody

object

required

The full request used for initiating this swap.

Option 1
Option 2

Show child attributes

requester

object

required

The user who initiated the request.

Show child attributes

failureReason

string

The failure reason, if any. Only present when status is Failed.

Last modified on June 8, 2026

List Sponsored Fees

Request Swap Quote

⌘I

​Flow Overview

​Swap object

Flow Overview

Swap object