Swap failed

Body

application/json

string

required

date

string<date-time>

required

kind

enum<string>

required

Available options:

swap.failed

data

object

required

Show child attributes

data.orgId

string

required

Organization id.

Required string length: 1 - 64

Example:

"or-30tnh-itmjs-s235s5ontr3r23h2"

data.swap

object

required

Show child attributes

data.swap.id

string

required

Swap id.

Required string length: 1 - 64

Example:

"swap-5ch70-fc3n7-3k2cbo8d7q5lnts4"

data.swap.quoteId

string

required

Id of the quote this swap is based on.

Required string length: 1 - 64

Example:

"swapQuote-7n9p0-cth75-6l74n2sj7u73ooeq"

data.swap.reference

string | null

required

Optional user-defined reference for this Swap.

data.swap.walletId

string

required

Id of the Dfns wallet spending the sourceAsset.

Required string length: 1 - 64

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

data.swap.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

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

data.swap.status

enum<string>

required

Swap status.

Available options:

PendingPolicyApproval,

InProgress,

Completed,

Failed,

Rejected

data.swap.provider

enum<string>

required

Swap provider.

Available options:

UniswapX,

UniswapClassic

data.swap.quotedSourceAsset

Native Asset · object

required

The source asset for this swap transaction.

Native Asset
EVM Fungible Token (ERC-20)

Show child attributes

data.swap.quotedSourceAsset.kind

enum<string>

required

Available options:

Native

data.swap.quotedSourceAsset.amount

string

required

data.swap.quotedSourceAsset.metadata

object

required

Show child attributes

data.swap.quotedSourceAsset.metadata.network

enum<string>

required

Available options:

Algorand,

AlgorandTestnet,

Aptos,

AptosTestnet,

ArbitrumOne,

ArbitrumSepolia,

AvalancheC,

AvalancheCFuji,

BabylonGenesis,

BabylonTestnet5,

Base,

BaseSepolia,

Berachain,

BerachainBepolia,

Bitcoin,

BitcoinSignet,

BitcoinTestnet3,

BitcoinCash,

Bob,

BobSepolia,

Bsc,

BscTestnet,

Canton,

CantonTestnet,

Cardano,

CardanoPreprod,

Celo,

CeloAlfajores,

Codex,

CodexSepolia,

CosmosHub4,

CosmosIcsTestnet,

Dogecoin,

Ethereum,

EthereumGoerli,

EthereumSepolia,

EthereumHolesky,

EthereumHoodi,

FantomOpera,

FantomTestnet,

FlareC,

FlareCCoston2,

FlowEvm,

FlowEvmTestnet,

Hedera,

HederaTestnet,

Ink,

InkSepolia,

InternetComputer,

Ion,

IonTestnet,

Iota,

IotaTestnet,

Kaspa,

Kusama,

KusamaAssetHub,

Litecoin,

Near,

NearTestnet,

Optimism,

OptimismSepolia,

Origyn,

Plasma,

PlasmaTestnet,

Plume,

PlumeSepolia,

Paseo,

PaseoAssetHub,

Polkadot,

PolkadotAssetHub,

Polygon,

PolygonAmoy,

Polymesh,

PolymeshTestnet,

Race,

RaceSepolia,

SeiAtlantic2,

SeiPacific1,

Solana,

SolanaDevnet,

Starknet,

StarknetSepolia,

Stellar,

StellarTestnet,

Sui,

SuiTestnet,

Tsc,

TscTestnet1,

Tezos,

TezosGhostnet,

Ton,

TonTestnet,

Tron,

TronNile,

Westend,

WestendAssetHub,

XrpLedger,

XrpLedgerTestnet

data.swap.quotedSourceAsset.metadata.decimals

number

required

data.swap.quotedSourceAsset.metadata.name

string

data.swap.quotedSourceAsset.metadata.symbol

string

data.swap.quotedSourceAsset.metadata.tid

string

data.swap.quotedTargetAsset

Native Asset · object

required

The target asset for this swap transaction.

Native Asset
EVM Fungible Token (ERC-20)

Show child attributes

data.swap.quotedTargetAsset.kind

enum<string>

required

Available options:

Native

data.swap.quotedTargetAsset.amount

string

required

data.swap.quotedTargetAsset.metadata

object

required

Show child attributes

data.swap.quotedTargetAsset.metadata.network

enum<string>

required

Available options:

Algorand,

AlgorandTestnet,

Aptos,

AptosTestnet,

ArbitrumOne,

ArbitrumSepolia,

AvalancheC,

AvalancheCFuji,

BabylonGenesis,

BabylonTestnet5,

Base,

BaseSepolia,

Berachain,

BerachainBepolia,

Bitcoin,

BitcoinSignet,

BitcoinTestnet3,

BitcoinCash,

Bob,

BobSepolia,

Bsc,

BscTestnet,

Canton,

CantonTestnet,

Cardano,

CardanoPreprod,

Celo,

CeloAlfajores,

Codex,

CodexSepolia,

CosmosHub4,

CosmosIcsTestnet,

Dogecoin,

Ethereum,

EthereumGoerli,

EthereumSepolia,

EthereumHolesky,

EthereumHoodi,

FantomOpera,

FantomTestnet,

FlareC,

FlareCCoston2,

FlowEvm,

FlowEvmTestnet,

Hedera,

HederaTestnet,

Ink,

InkSepolia,

InternetComputer,

Ion,

IonTestnet,

Iota,

IotaTestnet,

Kaspa,

Kusama,

KusamaAssetHub,

Litecoin,

Near,

NearTestnet,

Optimism,

OptimismSepolia,

Origyn,

Plasma,

PlasmaTestnet,

Plume,

PlumeSepolia,

Paseo,

PaseoAssetHub,

Polkadot,

PolkadotAssetHub,

Polygon,

PolygonAmoy,

Polymesh,

PolymeshTestnet,

Race,

RaceSepolia,

SeiAtlantic2,

SeiPacific1,

Solana,

SolanaDevnet,

Starknet,

StarknetSepolia,

Stellar,

StellarTestnet,

Sui,

SuiTestnet,

Tsc,

TscTestnet1,

Tezos,

TezosGhostnet,

Ton,

TonTestnet,

Tron,

TronNile,

Westend,

WestendAssetHub,

XrpLedger,

XrpLedgerTestnet

data.swap.quotedTargetAsset.metadata.decimals

number

required

data.swap.quotedTargetAsset.metadata.name

string

data.swap.quotedTargetAsset.metadata.symbol

string

data.swap.quotedTargetAsset.metadata.tid

string

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

data.swap.dateCreated

string<date-time>

required

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

data.swap.requestBody

object

required

The full request used for initiating this swap.

Option 1
Option 2

Show child attributes

data.swap.requestBody.quoteId

string

required

Quote to use for this swap.

Required string length: 1 - 64

Example:

"swapQuote-7n9p0-cth75-6l74n2sj7u73ooeq"

data.swap.requestBody.provider

enum<string>

required

Provided for this swap. Used for attesting that the swap is being created with the same parameters as the quote.

Available options:

UniswapX,

UniswapClassic

data.swap.requestBody.walletId

string

required

Id of the Dfns wallet spending the sourceAsset. Used for attesting that the swap is being created with the same parameters as the quote.

Required string length: 1 - 64

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

data.swap.requestBody.slippageBps

number

required

data.swap.requestBody.sourceAsset

Native Asset · object

required

The source asset that will be spent on the Swap transaction. Used for attesting that the swap is being created with the same parameters as the quote.

Native Asset
EVM Fungible Token (ERC-20)

Show child attributes

data.swap.requestBody.sourceAsset.kind

enum<string>

required

Available options:

Native

data.swap.requestBody.sourceAsset.amount

string

required

data.swap.requestBody.targetAsset

Native Asset · object

required

The target asset that will be received with the Swap transaction. Used for attesting that the swap is being created with the same parameters as the quote.

Native Asset
EVM Fungible Token (ERC-20)

Show child attributes

data.swap.requestBody.targetAsset.kind

enum<string>

required

Available options:

Native

data.swap.requestBody.targetAsset.amount

string

required

data.swap.requestBody.reference

string

An optional reference for this Swap.

data.swap.requestBody.targetWalletId

string

Id of the Dfns wallet receiving the target asset. Currently this value must be the same as the walletId. Used for attesting that the swap is being created with the same parameters as the quote.

Required string length: 1 - 64

Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

data.swap.requester

object

required

Show child attributes

data.swap.requester.userId

string

required

User (could be a service account) who requested the resource.

Required string length: 1 - 64

Example:

"us-6b58p-r53sr-rlrd3l5cj3uc4ome"

data.swap.requester.tokenId

string

Service Account token or Personal Access token used when requesting the resource.

Required string length: 1 - 64

Example:

"to-202a0-cdo33-o65mbt6q758lvvnt"

Example:

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

timestampSent

integer

required

deliveryAttempt

integer

required

Required range: x >= 1

retryOf

string

Response

200

Respond with a 200 to indicate that the event was successfully received. If your endpoint returns anything else than a 200 status code, we will consider the delivery has failed and retry later. See details here.

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Body

Response