Skip to main content
GET
/
swaps
/
quotes
/
{quoteId}
Get Swap Quote
curl --request GET \
  --url https://api.dfns.io/swaps/quotes/{quoteId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "swapQuote-3hgv4-q8tbf-8v2ajmrbmg6m4i9t",
  "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
  "targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
  "provider": "UniswapClassic",
  "sourceAsset": {
    "kind": "Native",
    "amount": "10000000000",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "Ethereum",
      "symbol": "SepoliaETH",
      "decimals": 18,
      "tid": "native:eth"
    }
  },
  "targetAsset": {
    "kind": "Erc20",
    "contract": "0xda0be7efd234295395d4204d0df4358339b57b27",
    "amount": "6467571553831928182",
    "metadata": {
      "network": "EthereumSepolia",
      "name": "Test",
      "symbol": "Test",
      "decimals": 18,
      "tid": "erc20:0xda0be7efd234295395d4204d0df4358339b57b27"
    }
  },
  "slippageBps": 100,
  "dateCreated": "2025-09-11T10:52:15.039Z",
  "requestBody": {
    "provider": "UniswapClassic",
    "walletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
    "targetWalletId": "wa-3l3cj-l8mq7-8q78f9nopq7f1qjv",
    "sourceAsset": {
      "kind": "Native",
      "amount": "10000000000"
    },
    "targetAsset": {
      "kind": "Erc20",
      "contract": "0xda0be7efd234295395d4204d0df4358339b57b27"
    },
    "slippageBps": 100
  },
  "requester": {
    "userId": "us-48r5q-eshfg-9pmr2lo6bmpr4i4i",
    "tokenId": "to-4etah-smoal-9n3rmhul4dpaueg5"
  }
}

​
Authentication

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

​
Required Permissions

No permission required.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
quoteId
string
required

The ID of the Swap Quote.

Required string length: 1 - 64

Response

200 - application/json

Success

​
id
string
required

ID of the Swap Quote.

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"

​
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"

​
provider
enum<string>
required

Swap provider.

Available options:
UniswapX,
UniswapClassic
​
sourceAsset
Native Asset · object
required

The source asset that will be spent on the swap transaction.

​
targetAsset
Native Asset · object
required

The target asset that will be received with the swap transaction.

​
slippageBps
number
required

The slippage tolerance for this trade in basis point (BPS). Slippage tolerance defines the maximum price difference you're 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 quote was created.

​
requestBody
object
required

The full request used for obtaining this quote.

​
requester
object
required

The user who initiated the request.

​
targetWalletId
string

If not provided, the walletId is used as the target wallet. If provided, this field is currently required to be the same as 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"

Last modified on March 5, 2026