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 per unit of base currency in terms of quote currency
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
original_quantity	string	The original quantity requested when the quote was created
consumed_quantity	string	The amount of the quote already used in executed trades
remaining_quantity	string	The amount still available to trade (original minus consumed)
is_exhausted	boolean	Whether the quote has been fully consumed. If true, no more trades can use this quote
exchange	object	Summary of what will be sent and received if the quote is executed
send_quantity	string	The amount you will send to execute the trade (e.g., 6.91)
send_currency	string	The currency you will send (e.g., USDT for a BUY order)
receive_quantity	string	The amount you will receive after the trade (e.g., 0.00010000)
receive_currency	string	The currency you will receive (e.g., BTC for a BUY order)

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