Get indicative swap quote

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_indicative_swap_quote \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "signWith": "<string>",
    "inputToken": "<string>",
    "outputToken": "<string>",
    "inputAmount": "<string>",
    "slippageBps": "<string>",
    "destinationAddress": "<string>",
    "feeSponsorship": "<boolean>",
    "fixedRate": "<boolean>"
}'

import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().getIndicativeSwapQuote({
  organizationId: "<string> (Unique identifier for a given Organization.)",
  signWith: "<string> (Wallet account address that would send the input asset. It must belong to the organization.)",
  inputToken: "<string> (CAIP-19 asset ID for the input asset.)",
  outputToken: "<string> (CAIP-19 asset ID for the output asset.)",
  inputAmount: "<string> (Exact base-unit amount of the input asset.)",
  slippageBps: "<string> (Maximum allowed slippage in basis points, at most 5000. When omitted, the provider chooses the slippage.)",
  destinationAddress: "<string> (Raw public address that would receive the output asset. Required for cross-protocol swaps and rejected otherwise.)",
  feeSponsorship: true // Preview the price with Turnkey paying the provider fees. Requires the FEATURE_NAME_SWAP_FEE_SPONSORSHIP organization feature. Defaults to false.,
  fixedRate: true // Preview a 1:1 conversion before fees between supported stablecoins. Requires the FEATURE_NAME_SWAP_FIXED_RATE organization feature. Defaults to false.
});

{
  "provider": "<string>",
  "outputAmount": "<string>",
  "minOutputAmount": "<string>",
  "slippageBps": "<string>",
  "clientFeeBps": "<string>",
  "estimatedTimeSeconds": "<string>",
  "feeSponsorship": "<boolean>",
  "fixedRate": "<boolean>",
  "estimatedFixedRateAdjustmentUsd": "<string>",
  "estimatedCharges": {
    "executionUsd": "<string>",
    "turnkeyFeeUsd": "<string>",
    "fixedRateAdjustmentUsd": "<string>"
  }
}

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_indicative_swap_quote \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "signWith": "<string>",
    "inputToken": "<string>",
    "outputToken": "<string>",
    "inputAmount": "<string>",
    "slippageBps": "<string>",
    "destinationAddress": "<string>",
    "feeSponsorship": "<boolean>",
    "fixedRate": "<boolean>"
}'

import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().getIndicativeSwapQuote({
  organizationId: "<string> (Unique identifier for a given Organization.)",
  signWith: "<string> (Wallet account address that would send the input asset. It must belong to the organization.)",
  inputToken: "<string> (CAIP-19 asset ID for the input asset.)",
  outputToken: "<string> (CAIP-19 asset ID for the output asset.)",
  inputAmount: "<string> (Exact base-unit amount of the input asset.)",
  slippageBps: "<string> (Maximum allowed slippage in basis points, at most 5000. When omitted, the provider chooses the slippage.)",
  destinationAddress: "<string> (Raw public address that would receive the output asset. Required for cross-protocol swaps and rejected otherwise.)",
  feeSponsorship: true // Preview the price with Turnkey paying the provider fees. Requires the FEATURE_NAME_SWAP_FEE_SPONSORSHIP organization feature. Defaults to false.,
  fixedRate: true // Preview a 1:1 conversion before fees between supported stablecoins. Requires the FEATURE_NAME_SWAP_FIXED_RATE organization feature. Defaults to false.
});

{
  "provider": "<string>",
  "outputAmount": "<string>",
  "minOutputAmount": "<string>",
  "slippageBps": "<string>",
  "clientFeeBps": "<string>",
  "estimatedTimeSeconds": "<string>",
  "feeSponsorship": "<boolean>",
  "fixedRate": "<boolean>",
  "estimatedFixedRateAdjustmentUsd": "<string>",
  "estimatedCharges": {
    "executionUsd": "<string>",
    "turnkeyFeeUsd": "<string>",
    "fixedRateAdjustmentUsd": "<string>"
  }
}

string

required

Unique identifier for a given Organization.

string

required

Wallet account address that would send the input asset. It must belong to the organization.

string

required

CAIP-19 asset ID for the input asset.

string

required

CAIP-19 asset ID for the output asset.

string

required

Exact base-unit amount of the input asset.

string

Maximum allowed slippage in basis points, at most 5000. When omitted, the provider chooses the slippage.

string

Raw public address that would receive the output asset. Required for cross-protocol swaps and rejected otherwise.

boolean

Preview the price with Turnkey paying the provider fees. Requires the FEATURE_NAME_SWAP_FEE_SPONSORSHIP organization feature. Defaults to false.

boolean

Preview a 1:1 conversion before fees between supported stablecoins. Requires the FEATURE_NAME_SWAP_FIXED_RATE organization feature. Defaults to false.

A successful response returns the following fields:

string

required

Swap provider that produced this quote.

string

required

Estimated base-unit amount of the output asset.

string

required

Minimum base-unit amount of the output asset after slippage.

string

Slippage tolerance in basis points the provider applied.

string

required

Client app fee in basis points included in this quote. “0” when no client fee applies.

string

Provider’s estimated time to complete the swap, in seconds.

boolean

required

Whether this quote has Turnkey paying the execution costs.

boolean

required

Whether this quote uses a 1:1 fixed rate.

string

Deprecated: use estimated_charges.fixed_rate_adjustment_usd. Estimated fixed-rate adjustment in USD from the customer’s side: positive is a cost, negative an earning. Present only for fixed-rate quotes the provider priced.

object

estimatedCharges field

Show estimatedCharges details

curl --request POST \
  --url https://api.turnkey.com/public/v1/query/get_indicative_swap_quote \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header "X-Stamp: <string> (see Authorizations)" \
  --data '{
    "organizationId": "<string>",
    "signWith": "<string>",
    "inputToken": "<string>",
    "outputToken": "<string>",
    "inputAmount": "<string>",
    "slippageBps": "<string>",
    "destinationAddress": "<string>",
    "feeSponsorship": "<boolean>",
    "fixedRate": "<boolean>"
}'

import { Turnkey } from "@turnkey/sdk-server";

const turnkeyClient = new Turnkey({
  apiBaseUrl: "https://api.turnkey.com",
  apiPublicKey: process.env.API_PUBLIC_KEY!,
  apiPrivateKey: process.env.API_PRIVATE_KEY!,
  defaultOrganizationId: process.env.ORGANIZATION_ID!,
});

const response = await turnkeyClient.apiClient().getIndicativeSwapQuote({
  organizationId: "<string> (Unique identifier for a given Organization.)",
  signWith: "<string> (Wallet account address that would send the input asset. It must belong to the organization.)",
  inputToken: "<string> (CAIP-19 asset ID for the input asset.)",
  outputToken: "<string> (CAIP-19 asset ID for the output asset.)",
  inputAmount: "<string> (Exact base-unit amount of the input asset.)",
  slippageBps: "<string> (Maximum allowed slippage in basis points, at most 5000. When omitted, the provider chooses the slippage.)",
  destinationAddress: "<string> (Raw public address that would receive the output asset. Required for cross-protocol swaps and rejected otherwise.)",
  feeSponsorship: true // Preview the price with Turnkey paying the provider fees. Requires the FEATURE_NAME_SWAP_FEE_SPONSORSHIP organization feature. Defaults to false.,
  fixedRate: true // Preview a 1:1 conversion before fees between supported stablecoins. Requires the FEATURE_NAME_SWAP_FIXED_RATE organization feature. Defaults to false.
});

{
  "provider": "<string>",
  "outputAmount": "<string>",
  "minOutputAmount": "<string>",
  "slippageBps": "<string>",
  "clientFeeBps": "<string>",
  "estimatedTimeSeconds": "<string>",
  "feeSponsorship": "<boolean>",
  "fixedRate": "<boolean>",
  "estimatedFixedRateAdjustmentUsd": "<string>",
  "estimatedCharges": {
    "executionUsd": "<string>",
    "turnkeyFeeUsd": "<string>",
    "fixedRateAdjustmentUsd": "<string>"
  }
}

REST API

SDK reference

Get indicative swap quote