---
title: "Request FX swap estimation"
method: POST
path: "/api/v1/fx/estimate"
tags: ["FX"]
---

# Request FX swap estimation

`POST /api/v1/fx/estimate`

## Request

- Base URL: `https://api-business.wirexapp.com`
- URL: `https://api-business.wirexapp.com/api/v1/fx/estimate`
- Auth: API key in header `Authorization`

Creates swap estimation. Returns deposit address where corporation sends source tokens.

## Request body

- RequestFxEstimateRequest
  - `correlation_id` string: CorrelationId is an optional client-provided identifier for tracking the request
  - `destination_asset_address` string, required: Token contract address of destination asset
  - `destination_asset_amount` string: Amount to receive (mutually exclusive with source_asset_amount)
  - `source_asset_address` string, required: Token contract address of source asset
  - `source_asset_amount` string: Amount to swap (mutually exclusive with destination_asset_amount)

## Response `200`

OK

- ResponseFxEstimateResponse
  - `deposit_address` string, required: Circle wallet address for token deposit
  - `destination_asset_address` string, required: Destination token contract address
  - `destination_asset_amount` string, required: Calculated destination amount
  - `estimation_id` string, required: UUID required for execution
  - `expiration_time` string, required: ISO 8601 expiration timestamp
  - `source_asset_address` string, required: Source token contract address
  - `source_asset_amount` string, required: Calculated source amount
  - `trade_rate` string, required: Exchange rate applied

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api.md) - [All operations](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/revisions/6525bfbc8f99?raw)
