---
title: "Crear una cotización de conversión"
method: POST
path: "/currency_conversions"
tags: ["currencyConversions"]
---

# Crear una cotización de conversión

`POST /currency_conversions`

Crea una cotización con tipo de cambio fijo (estado `awaiting_confirmation`, válida 1 hora) para convertir balance entre GTQ y USD. Envía **uno solo de los dos montos**: `source_amount_in_cents` si sabes cuánto quieres convertir, o `destination_amount_in_cents` si sabes cuánto quieres recibir — la dirección se infiere del monto que envíes. Confírmala con `POST /currency_conversions/{id}/confirm`. Requiere movimiento de dinero habilitado.

## Headers

- `X-SECRET-KEY` string, required
- `Idempotency-Key` string

## Request body

- object
  - `source_currency` 'GTQ' | 'USD', required
  - `destination_currency` 'GTQ' | 'USD', required
  - `source_amount_in_cents` integer — Envía este monto si sabes cuánto quieres convertir del balance de origen (exact-in)
  - `destination_amount_in_cents` integer — O envía solo este monto si sabes cuánto quieres recibir en la moneda destino (exact-out)

## Response `201`

Cotización creada

- CurrencyConversion
  - `id` string
  - `status` 'awaiting_confirmation' | 'pending' | 'processed' | 'reverted'
  - `source_currency` string
  - `source_amount_in_cents` integer
  - `destination_currency` string
  - `destination_amount_in_cents` integer
  - `exchange_rate` number, double
  - `expires_at` string, date-time, nullable
  - `created_at` string, date-time

---

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