Create Quote

Retrieve a real-time conversion quote between USDT and Bitcoin.

This endpoint allows you to preview the expected rate, amount received, and validity period for a USDT ↔ BTC trade. Quotes can be used to show customers live pricing or to execute a trade with a locked rate.

Endpoint

Purpose

Use this endpoint to:

Display current pricing before executing a trade

Evaluate exact cost or return amount for conversions

Fetch trade metadata (fees, expiry, reference) before committing

Create Quote Request

parameter	type	required	description
base_currency	string	Yes	The base currency for the trade. Example: BTC,USDC
quote_currency	string	Yes	The quote currency for the trade. Example: USDT, but mostly USDT
side	string	Yes	The side of the trade. One of: buy or sell
quantity	string	Yes	The amount of base currency to trade. Example: 0.0001

Example Request

Successful Response (200 OK)

Response Body

Response Fields

field	type	description
id	string	Unique ID for this quote. Use it when executing the trade
base_currency	string	The base currency for the trade (e.g., BTC)
quote_currency	string	The quote currency for the trade (e.g., USDT)
side	string	The side of the trade (buy or sell)
quantity	string	The amount of base currency to trade
price	string	The quoted price for the trade
spread_bps	integer	The spread in basis points applied to the quote
expires_at	string	ISO 8601 timestamp after which this quote is no longer valid
created_at	string	ISO 8601 timestamp when the quote was created

Notes

Quotes are valid for a short time (usually 30 seconds for development and 10 seconds in production)

Use the quoteId in /trading/quotes to ensure price locking

Use the price from the quote when creating the order.

Without quoteId, the trade executes at current market rate

Fees depend on your integration tier (default is 0)

Errors

code	message	fix
400	Invalid asset pair	Only use USDT ↔ BTC
400	Missing or invalid amount	Must be a valid positive integer
403	Insufficient balance	Only applies if pre-balance checks are enabled
500	Quote service unavailable	Retry or contact support if persistent