---
title: "Create Conversion"
method: POST
path: "/v1/ramp/conversion"
tags: ["Conversions"]
---

# Create Conversion

`POST /v1/ramp/conversion`

Initiate Fiat and Crypto conversion. [  *Stablecoin Account API Publisher Disclaimer*](/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer)

## Headers

- `x-on-behalf-of` string
- `x-idempotency-key` string, uuid

## Request body

- ConversionCreateRequest
  - `quote_id` string, required — Quote ID
  - `sell_currency` string, required — Selling currency
  - `sell_amount` string, required — Selling amount
  - `buy_currency` string, required — Buying currency
  - `buy_amount` string, required — Buying amount
  - `reason` string — Transaction remark

## Response `200`

Conversion executed successfully

- ConversionCreateResponse
  - `code` integer, required
  - `message` string, required
  - `data` ConversionCreateData, required — Base schema with shared fields for all conversion responses
    - `order_id` string, uuid, required — Order ID (long)
    - `short_order_id` string, required — Order ID (short)
    - `status` 'Submit Failed' | 'Failed' | 'Pending' | 'Success' | 'Submitted', required — Order status
    - `sell_currency` string, required — Selling currency
    - `sell_amount` string, required — Selling amount
    - `buy_currency` string, required — Buying currency
    - `buy_amount` string, required — Buying amount
    - `quote_price` string, required — Exchange rate used for conversion
    - `processing_fee` string, required — Processing fee
    - `network_fee` string, required — Network fee
    - `reason` string — Transaction remark
    - `order_type` string, required — Order type (Sell or Buy)

---

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