---
title: "Create Quote Execution"
method: POST
path: "/profiles/{profile_id}/quote-executions"
tags: ["Quote Executions"]
---

# Create Quote Execution

`POST /profiles/{profile_id}/quote-executions`

Execute on a quote for buying or selling an asset.

The side, market, and guaranteed price of the execution are specified by the quote
with ID `quote_id`.

The amount to buy or sell must be specified in either fiat or crypto by setting
exactly one of:
 - `base_amount` to specify the amount of crypto to buy or sell.
 - `quote_amount` to specify the amount of fiat to spend or acquire.

An otherwise-valid request to create a quote execution may fail with the following
types of errors:
 - [Expired](https://developer.paxos.com/docs/v2/problems/expired) if the quote
   with ID `quote_id` has expired.
 - [Insufficient Funds](https://developer.paxos.com/docs/v2/problems/insufficient-funds)
   if the profile with ID `profile_id` has insufficient available balance to
   fund the execution.
 - [Rejected](https://developer.paxos.com/docs/v2/problems/rejected) if extreme
   market conditions (e.g. a very large price swing) have invalidated the quote.
 - [Already Exists](https://developer.paxos.com/docs/v2/problems/already-exists)
   if a Quote Execution with the same `ref_id` has already been created.

## Path parameters

- `profile_id` string, required

## Request body

- ExchangePublicCreateQuoteExecutionBody
  - `quote_id` string, required — The ID of the held Quote for buying or selling some asset.
  - `ref_id` string — A unique identifier for the quote execution (for idempotence).
  - `base_amount` string — The amount of the base asset (crypto) to buy or sell using the specified quote. The maximum precision is 8 decimals.
  - `quote_amount` string — The amount of the quote asset (fiat) to spend or acquire using the specified quote. The maximum precision is 2 decimals.
  - `metadata` object — Metadata to store on the quote execution. Up to 6 key/value pairs may be stored, with each key and value at most 100 characters.
  - `identity_id` string — The end user that requests the quote execution.
  - `account_id` string — The account under which this quote execution is placed. The provided identity must be allowed to trade on behalf of this account.
  - `recipient_profile_id` string — The ID of the profile under which to deposit the funds.

## Response `200`

A successful response.

- QuoteExecution — A QuoteExecution is an order to buy or sell an asset at a particular held Quote.
  - `id` string, required — The UUID of the quote execution.
  - `profile_id` string, required — The ID of the profile under which this order executed.
  - `quote_id` string, required — The ID of the quote used to create this quote execution.
  - `ref_id` string — A unique identifier for the quote execution creation (for idempotence).
  - `status` 'CREATED' | 'SETTLED', required — A QuoteExecution begins in state `CREATED` and transitions to end state `SETTLED` when all accounting movements are complete.
  - `market` 'ETHEUR' | 'ETHSGD' | 'ETHUSD' | 'BTCEUR' | 'BTCSGD' | 'BTCUSD' | 'PAXGUSD' | 'BCHUSD' | 'LTCUSD' | 'USDPUSD' | 'LINKUSD' | 'AAVEUSD' | 'UNIUSD' | 'PEPEUSD' | 'TRUMPUSD' | 'SHIBUSD' | 'ARBUSD' | 'BONKUSD' | 'ENAUSD' | 'MNTUSD' | 'ONDOUSD' | 'PENGUUSD' | 'QNTUSD' | 'RENDERUSD' | 'SKYUSD' | 'WIFUSD' | 'WLDUSD' | 'DOGEUSD' | 'AVAXUSD' | 'SUIUSD' | 'POLUSD' | 'XLMUSD' | 'BNBUSD', required
  - `side` 'BUY' | 'SELL', required — Trade side.
  - `price` string, decimal, required — The guaranteed price of the quote.
  - `base_amount` string, decimal, required — The amount of assets (crypto) in the transaction.
  - `base_asset` string, required — The "base" side of the trading pair (crypto - like BTC, ETH, PAXG).
  - `quote_amount` string, decimal, required — The amount of quote currency (cash) in the transaction.
  - `quote_asset` string, required — The "quote" side of the trading pair (fiat - like USD, EUR, SGD).
  - `created_at` string, date-time, required — The time at which the quote execution was created.
  - `settled_at` string, date-time — The time at which the quote execution was settled, completing its lifecycle.
  - `metadata` object — Client-specified metadata.
  - `identity_id` string — The identity under which this quote execution is placed.
  - `account_id` string — The account under which this quote execution is placed.
  - `recipient_profile_id` string — The ID of the profile under which to deposit the funds.

## Other responses

- `403` — Could not create quote execution
- `404` — Could not find quote
- `409` — Quote Execution 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)