Swaps

Get Quotes

Get available quotes for a swap between two assets.

post/api/v1/swaps/quotes

Request body

vault_idstring uuid required

The unique identifier of the vault.

amountstring required

The amount to swap.

slippage_bpsstring

The slippage tolerance in basis points.

signer_type'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user'

requested_provider_idsProviderId[]

The provider ids to use for the quote. If empty, all providers will be used.

Example request

{
  "input_asset_identifier": {
    "details": {
      "token": {
        "base58_repr": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA"
      }
    }
  },
  "output_asset_identifier": {
    "details": {
      "token": {
        "base58_repr": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA"
      }
    }
  },
  "amount": "1000000000000000000",
  "slippage_bps": "1000000000000000000"
}

Response

Successful Response

Changes

Changed in 2 of the 7 revisions of this API.31513

Aug 16, 202661a784d5855037See the full diff
- ▲
  added RippleAssetIdentifier to the providers_with_quote/items/quote/input_asset_identifier response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added RippleAssetIdentifier to the providers_with_quote/items/quote/output_asset_identifier response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added RippleAssetIdentifier to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier response property oneOf list for the response status 200
  response-property-one-of-added
- ○
  added ripple discriminator mapping keys to the input_asset_identifier request property
  request-property-discriminator-mapping-added
- ○
  added ripple discriminator mapping keys to the output_asset_identifier request property
  request-property-discriminator-mapping-added
- ○
  added RippleAssetIdentifierRequest to the input_asset_identifier request property oneOf list
  request-property-one-of-added
- ○
  added RippleAssetIdentifierRequest to the output_asset_identifier request property oneOf list
  request-property-one-of-added
- ○
  added ripple discriminator mapping keys to the providers_with_quote/items/quote/input_asset_identifier response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  added ripple discriminator mapping keys to the providers_with_quote/items/quote/output_asset_identifier response property for the response status 200
  response-property-discriminator-mapping-added
- ○
  added ripple discriminator mapping keys to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier response property for the response status 200
  response-property-discriminator-mapping-added
Aug 9, 2026c4c28d233105156See the full diff
- ●
  added the new exchange_paxos enum value to the providers_with_quote/items/quote/input_asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifier]/chain/unique_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new exchange_paxos enum value to the providers_with_quote/items/quote/output_asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifier]/chain/unique_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new exchange_paxos enum value to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifier]/chain/unique_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new paxos enum value to the providers_with_quote/items/quote/input_asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifier]/exchange_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new paxos enum value to the providers_with_quote/items/quote/output_asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifier]/exchange_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new paxos enum value to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifier]/exchange_type response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/input_asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/chain/unique_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/input_asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/details/oneOf[subschema #1: TonNativeAssetIdentifierRequest]/chain response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/input_asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/details/oneOf[subschema #2: TonJettonAssetIdentifierRequest]/jetton/chain response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/output_asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/chain/unique_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/output_asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/details/oneOf[subschema #1: TonNativeAssetIdentifierRequest]/chain response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/output_asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/details/oneOf[subschema #2: TonJettonAssetIdentifierRequest]/jetton/chain response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/chain/unique_id response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/details/oneOf[subschema #1: TonNativeAssetIdentifierRequest]/chain response property for the response status 200
  response-property-enum-value-added
- ●
  added the new ton_testnet enum value to the providers_with_quote/items/quote/provider_fee/priced_asset/asset_info/asset_identifier/oneOf[subschema #12: TonAssetIdentifier]/details/oneOf[subschema #2: TonJettonAssetIdentifierRequest]/jetton/chain response property for the response status 200
  response-property-enum-value-added
- ○
  added the new paxos enum value to the request property input_asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifierRequest]/exchange_type
  request-property-enum-value-added
- ○
  added the new paxos enum value to the request property output_asset_identifier/oneOf[subschema #6: ExchangeAssetIdentifierRequest]/exchange_type
  request-property-enum-value-added
- ○
  added the new ton_testnet enum value to the request property input_asset_identifier/oneOf[subschema #12: TonAssetIdentifierRequest]/details/oneOf[subschema #1: TonNativeAssetIdentifierRequest]/chain
  request-property-enum-value-added
- ○
  added the new ton_testnet enum value to the request property input_asset_identifier/oneOf[subschema #12: TonAssetIdentifierRequest]/details/oneOf[subschema #2: TonJettonAssetIdentifierRequest]/jetton/chain
  request-property-enum-value-added
- ○
  added the new ton_testnet enum value to the request property output_asset_identifier/oneOf[subschema #12: TonAssetIdentifierRequest]/details/oneOf[subschema #1: TonNativeAssetIdentifierRequest]/chain
  request-property-enum-value-added
- ○
  added the new ton_testnet enum value to the request property output_asset_identifier/oneOf[subschema #12: TonAssetIdentifierRequest]/details/oneOf[subschema #2: TonJettonAssetIdentifierRequest]/jetton/chain
  request-property-enum-value-added

Full history