---
title: "Create Stablecoin Conversion"
method: POST
path: "/conversion/stablecoins"
tags: ["Stablecoin Conversion"]
deprecated: true
---

# Create Stablecoin Conversion

`POST /conversion/stablecoins`

> **Deprecated.**

Create a Conversion request to exchange assets 1:1.

A request to create a conversion can fail with one of the following
types of errors:
 - [Insufficient Funds](https://developer.paxos.com/docs/v2/problems/insufficient-funds)
   if the Profile (`profile_id`) has insufficient available balance to
   fund the execution.
 - [Already Exists](https://developer.paxos.com/docs/v2/problems/already-exists)
   if a conversion with the same external ID (`ref_id`) has already been created.

## Request body

- CreateStablecoinConversionRequest
  - `profile_id` string, required — The Profile associated with a conversion.
  - `amount` string, required — Asset amount to convert. [Details](https://docs.paxos.com/developer/convert#assets).
  - `source_asset` string, required — The asset to convert from. [Details](https://docs.paxos.com/developer/convert#assets).
  - `target_asset` string, required — The asset to convert to. [Details](https://docs.paxos.com/developer/convert#assets).
  - `ref_id` string — Client provided, unique Reference ID for lookup and replay protection.
  - `identity_id` string — The Identity ID associated with the user requesting the conversion. Required only for customers with [3rd-Party integrations](/crypto-brokerage/ledger-type#fiat-and-crypto-subledger).
  - `account_id` string — The Account ID associated with the user requesting the conversion. Required only for customers with [3rd-Party integrations](/crypto-brokerage/ledger-type#fiat-and-crypto-subledger).
  - `metadata` object — Optional client-specified stored metadata.
  - `recipient_profile_id` string — For directed settlement, the receiving side `profile_id`.

## Response `200`

A successful response.

- StablecoinConversion
  - `id` string — System provided UUID for the conversion is provided in the [Create Stablecoin Conversion](#operation/CreateStablecoinConversion) response. Required parameter for the [Get Stablecoin Conversion](#operation/GetStablecoinConversion) request.
  - `profile_id` string — The Profile associated with a conversion. Required in the [Create Stablecoin Conversion](#operation/CreateStablecoinConversion) request.
  - `amount` string, decimal — Asset amount to convert. [Details](https://docs.paxos.com/developer/convert#assets).
  - `source_asset` string — The asset to convert from. [Details](https://docs.paxos.com/developer/convert#assets).
  - `target_asset` string — The asset to convert to. [Details](https://docs.paxos.com/developer/convert#assets).
  - `status` string — The current status of the conversion. [Details](https://docs.paxos.com/developer/convert#stablecoin-conversion-statuses).
  - `ref_id` string — Client provided, unique Reference ID included the [Create Stablecoin Conversion](#operation/CreateStablecoinConversion) request.
  - `identity_id` string — The Identity ID associated with the user requesting the conversion. Required only for customers with [3rd-Party integrations](/crypto-brokerage/ledger-type#fiat-and-crypto-subledger).
  - `account_id` string — The Account ID associated with the user requesting the conversion. Required only for customers with [3rd-Party integrations](/crypto-brokerage/ledger-type#fiat-and-crypto-subledger).
  - `created_at` string, date-time — The time at which the conversion was requested. See RFC3339 format, like `2006-01-02T15:04:05Z`.
  - `updated_at` string, date-time — The time at which the conversion was last updated. RFC3339 format, like `2006-01-02T15:04:05Z`.
  - `settled_at` string, date-time — The time at which the conversion was settled. [Details](https://docs.paxos.com/developer/convert#stablecoin-conversion-statuses). RFC3339 format, like `2006-01-02T15:04:05Z`.
  - `cancelled_at` string, date-time — The time at which the conversion has been cancelled. [Details](https://docs.paxos.com/developer/convert#stablecoin-conversion-statuses). RFC3339 format, like `2006-01-02T15:04:05Z`.
  - `metadata` object — Optional client-specified stored metadata.
  - `recipient_profile_id` string — For directed settlement, the receiving side `profile_id`.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Already Exists

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)