---
title: "Get FX Rate"
method: POST
path: "/v1/instances/{instance_id}/quotes/fx"
tags: ["Payouts Quotes"]
---

# Get FX Rate

`POST /v1/instances/{instance_id}/quotes/fx`

## Path parameters

- `instance_id` string, required

## Headers

- `Idempotency-Key` string — Optional key to safely retry this request without performing the action twice. Retrying with the same key and an identical body replays the original response; reusing a key with a different body returns an error. Keys are kept for 24 hours.

## Request body

- object
  - `from` 'USDC' | 'USDT' | 'USDB', required
  - `to` 'BRL' | 'USD' | 'MXN' | 'COP' | 'ARS' | 'EUR', required
  - `request_amount` integer, required — 1000 represents 10.00, 2050 represents 20.50
  - `currency_type` 'sender' | 'receiver', required

## Response `200`

Check FX rate response

- object
  - `commercial_quotation` number, nullable, required — 1 USD = 4.95 BRL
  - `blindpay_quotation` number, nullable, required — 1 USD = 4.85 BRL (commercial quotation - (blindpay taxes))
  - `result_amount` number, required
  - `instance_flat_fee` number, nullable — 0.5 USDC
  - `instance_percentage_fee` number, required

## Other responses

- `400` — Possible error codes: `BANK_ACCOUNTS_INCOMPLETE`, `QUOTES_RATE_UNAVAILABLE`, `VALIDATION_FAILED`. See the Error responses section for retry semantics.
- `401` — Possible error codes: `AUTH_UNAUTHORIZED`. See the Error responses section for retry semantics.
- `403` — Possible error codes: `AUTH_FORBIDDEN`. See the Error responses section for retry semantics.
- `429` — Possible error codes: `AUTH_RATE_LIMITED`. See the Error responses section for retry semantics.
- `500` — Possible error codes: `INTERNAL_ERROR`. See the Error responses section for retry semantics.
- `503` — Possible error codes: `QUOTES_RATE_UNAVAILABLE`. See the Error responses section for retry semantics.

---

[API](https://skmtc.dev/blindpay/apis/blindpay-api.md) · [All operations](https://skmtc.dev/blindpay/apis/blindpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blindpay/blindpay-api/revisions/470de27afb7b/schema)