---
title: "Create Swap Quote"
method: POST
path: "/swaps/quote"
tags: ["Swaps"]
---

# Create Swap Quote

`POST /swaps/quote`

Previews the price of a swap. Fiat pairs quote the in-ledger mid-market conversion — the same rate creating the swap fills at. No funds move and nothing is saved.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `amount` string, required — Source token amount.
  - `from_address` string, nullable — Source wallet address used for the quote.
  - `from_chain` union — Source chain name or chain ID. Defaults to the source token's chain when omitted.
    - string
    - integer
  - `from_token` string, required — Source token contract address or ticker symbol, such as "USDT".
  - `metadata` object — Metadata to include with the quote response.
  - `slippage_bps` integer, nullable — Maximum slippage tolerance in basis points.
  - `to_address` string, nullable — Destination wallet address used for the quote.
  - `to_chain` union — Destination chain name or chain ID. Defaults to the destination token's chain when omitted.
    - string
    - integer
  - `to_token` string, required — Destination token contract address or ticker symbol, such as "XAUT".

## Response `200`

swap quote created

- object
  - `amount_in` string, required — Source token amount used for the quote.
  - `amount_out` string, required — Estimated destination token amount.
  - `amount_out_min` string — Minimum destination amount after slippage.
  - `bridge_fee` string, nullable — Estimated bridge fee for cross-chain swaps.
  - `estimated_duration_seconds` integer, nullable — Estimated time for the swap to complete.
  - `fee_bps` integer, required — Whop fee in basis points.
  - `from_address` string, nullable — Source wallet address used for the quote.
  - `from_token` object, required — Resolved source token details.
  - `metadata` object, required — Metadata from the request.
  - `object` 'swap_quote', required
  - `rate` string, required — Quoted exchange rate.
  - `requires_token_approval` boolean, nullable — Whether the source token needs approval before swapping.
  - `to_address` string, nullable — Destination wallet address used for the quote.
  - `to_token` object, required — Resolved destination token details.

## Other responses

- `400` — Invalid Parameters

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/866821546d67/schema)