Skip to main content
GET
/
swaps
/
{swapId}
Get Swap
curl --request GET \
  --url https://api.dfns.io/swaps/{swapId} \
  --header 'Authorization: Bearer <token>'
{
  "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"
  }
}

​
Authentication

✅ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Swaps:Read: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Path Parameters

​
swapId
string
required

Id of the swap for which we want to get details.

Required string length: 1 - 64

Response

200 - application/json

Success

​
id
string
required

Swap id.

Required string length: 1 - 64
Example:

"swap-5ch70-fc3n7-3k2cbo8d7q5lnts4"

​
quoteId
string
required

Id of the quote this swap is based on.

Required string length: 1 - 64
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
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
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)
​
quotedTargetAsset
Native Asset · object
required

The target asset for this swap transaction.

  • Native Asset
  • EVM Fungible Token (ERC-20)
​
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
​
requester
object
required