Buy Quote
Generate a price-locked quote for a Buy onramp transaction. Pass the returned quote id as quote_id when creating the transaction to lock the price.
Onramp Price Lock
Onramp Buy, Pool Buy, and External Buy transactions are price-locked only when they are created from a quote. Call the matching quote endpoint first, then pass the returned quote id as quote_id when creating the transaction.
Authentication uses the same HMAC client auth as the other client endpoints.
Request rules
- Provide exactly one of
from_amountorto_amount— not both, not neither.
Response fields
| Field | Meaning |
|---|---|
id | Quote id. Pass this as quote_id when creating the transaction. |
expiry | Price-lock expiry. The quote must be used to create a transaction before this time. |
settlement_expiry | Deadline by which the transaction must be completed (deposit settled). |
final_price | Locked price used for the transaction. |
fee_breakup keys | platform_fee, network_fee, client_fee, discount, tax_on_fee, tds |
A quote is single-use and tied to the client that created it.
Headers
Your API key (configured in credentials)
HMAC-SHA256 signature (auto-generated) To test manually: HMAC-SHA256 of apiKey + timestamp (or apiKey + timestamp + userId when X-User-Id is required), keyed with your API secret. The HMAC Generator flow computes this for you.
Unix timestamp in seconds (auto-generated) Unix seconds, e.g. Math.floor(Date.now() / 1000). Must match the timestamp used in the X-Signature computation.
Unique request identifier (auto-generated) Any unique string per request, e.g. a UUID.
User UUID (set above)
Body
Fiat currency for the onramp transaction.
Crypto currency for the onramp transaction.
Payment method used to complete the onramp deposit leg.
Fiat amount. Provide exactly one of from_amount or to_amount (not both, not neither).
Crypto amount. Provide exactly one of from_amount or to_amount (not both, not neither).
Related topics
Pool Buy QuoteExternal Buy QuoteFetching QuoteCreate External BuyCreate Pool Buy Transaction