Create Price Quote

Creates a firm price quote for a customer — a locked rate the customer can trade at, valid for a short window.

Prerequisites

The customer must already exist and have an approved KYC status.

⚠️ Important

Quotes are short-lived — place the order before expiry. An expired or already-consumed quote is rejected with 409 CONFLICT.

Unlike the indicative rate endpoint, customerId is required here (as a query parameter) because the quote is priced against the customer's fee tier and compliance status.

⚠️ Required Fields (Query)

Field	Type	Description	Constraints
`customerId`	`string (uuid)`	ID of the KYC-approved customer the quote is priced for	Required

⚠️ Required Fields (Body)

Field	Type	Description	Constraints
`side`	`string`	Trade direction: `buy` or `sell` (from the customer's perspective)	Required
`crypto`	`object`	The crypto leg of the trade	Required
`crypto.asset`	`string`	Crypto ticker (e.g. `BTC`, `USDT`)	Required · 1-10 chars · `^[A-Za-z0-9]{1,10}$`
`crypto.amount`	`number`	Crypto quantity to quote	Required · Min: `0.00000001` · Max: `1e15`
`fiat`	`object`	The fiat leg of the trade	Required
`fiat.asset`	`string`	Fiat code (e.g. `USD`, `EUR`)	Required · 1-10 chars · `^[A-Za-z0-9]{1,10}$`

Related endpoints: GET /api/v1/quote/{fromAsset}/{toAsset} · POST /api/v1/order

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

API Key

Add parameter in header

X-Timestamp

Example:

X-Timestamp: ********************

API Key

Add parameter in header

X-Nonce

Example:

X-Nonce: ********************

API Key

Add parameter in header

X-Body-Hash

Example:

X-Body-Hash: ********************

API Key

Add parameter in header

X-Signature

Example:

X-Signature: ********************

Query Params

Body Params

application/json-patch+json

Examples

curl --location --request POST '/api/v1/quote?customerId=' \ --header 'X-API-Key: <api-key>' \ --header 'X-Timestamp: <api-key>' \ --header 'X-Nonce: <api-key>' \ --header 'X-Body-Hash: <api-key>' \ --header 'X-Signature: <api-key>' \ --header 'Content-Type: application/json-patch+json' \ --data ''

{ "success": true, "message": null, "data": { "fromAsset": "USDT", "toAsset": "USD", "oneCoinValue": 1, "assetValue": 20, "fee": 1.5, "totalAmount": 18.5, "exchangeRate": "1" }, "errors": [] }

Request

Responses