---
title: "Price a transfer between the client's own accounts"
method: POST
path: "/swaps/preview"
tags: ["transfers"]
---

# Price a transfer between the client's own accounts

`POST /swaps/preview`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hevn-inc/apis/hevn-api/docs/swaps/preview/post.ts> (a function with typed inputs; its response is checked against the schema)

Compare every route that can serve this pair of accounts and return the best price. Nothing is booked with a provider and nothing is signed.

## Headers

- `X-Hevn-Account` string, nullable: The client account to act for, as a `cl_…` id. Omit it to act as yourself.

## Request body

- SwapPreviewRequest
  - `sourceAccount` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS', required
  - `destinationAccount` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS', required
  - `amount` string, nullable: Exact amount to debit from the source account.
  - `amountTo` string, nullable: Exact amount the destination account should receive.

## Response `200`

Successful Response

- SwapPreviewResponse
  - `sourceAccount` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS', required
  - `destinationAccount` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS', required
  - `quote` SwapQuoteView, required
    - `fromAmount` string, required: Amount debited from the source account.
    - `fromCurrency` string, required: Currency or digital asset debited.
    - `toAmount` string, required: Amount credited to the destination account.
    - `toCurrency` string, required: Currency or digital asset credited.
    - `rate` string, required: Conversion rate from the source amount to the destination amount.
    - `feeAmount` string, required: Total fee charged in feeCurrency.
    - `feeCurrency` string, required: Currency in which the fee is charged.
    - `minimumToAmount` string, nullable: Worst-case amount credited when the route carries slippage.
    - `estimated` boolean: Whether the delivered amount is an estimate settled later, rather than a locked price.
    - `etaHours` integer, nullable: Expected hours until the destination account is credited.
    - `expiresAt` string, date-time, nullable: UTC timestamp after which this price is no longer honored.

## Other responses

- `422`: Request validation failed

## Changes

- **2026-11-12** `299a3aa6f521`: 3 warning, 4 info
  - added the new `FDIC_EUR` enum value to the `destinationAccount` response property for the response status `200`
  - added the new `FDIC_EUR` enum value to the `sourceAccount` response property for the response status `200`
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - added the new `FDIC_EUR` enum value to the request property `destinationAccount`
  - …3 more
- **2026-10-23** `a02795de2d2b`: 15 warning, 11 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `KYC_CARDS` enum value to the `destinationAccount` response property for the response status `200`
  - added the new `KYC_CARDS` enum value to the `sourceAccount` response property for the response status `200`
  - added the new `RD` enum value to the `destinationAccount` response property for the response status `200`
  - …22 more
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `bd6c9d69540e`: 1 warning
  - added the new `phone_in_use` enum value to the `error/code` response property for the response status `422`
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `document_fields_missing` enum value from the `error/code` response property for the response status `422`

[Operation history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/swaps/preview/post.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)