Skip to main content

​
Create Quote

Request a real-time quote to lock in exchange rates and fees before initiating a transaction. Quotes expire after 3 minutes.

​
Endpoint

POST /v1/quotes

​
Request

curl -X POST https://api.thiqwave.com/v1/quotes \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "payin",
    "source_currency": "AED",
    "destination_currency": "USDT",
    "destination_network": "ethereum",
    "amount": 50000,
    "corridor": "uae"
  }'

​
Request Body

FieldTypeRequiredDescription
typestringYesTransaction type: "payin", "payout", "bridge", or "onchain_fx"
source_currencystringYesFiat code (AED, SAR, USD, EUR, GBP) or stablecoin (USDT, USDC)
source_networkstringConditionalRequired when source is a stablecoin. Blockchain network: ethereum, base, polygon, tron, stellar, solana, xrpl, sui, hedera
destination_currencystringYesFiat code or stablecoin
destination_networkstringConditionalRequired when destination is a stablecoin
amountinteger (fiat) or string (stablecoin)YesFiat in smallest currency unit (e.g., 50000 AED fils); stablecoin in human-readable format (e.g., "500.00")
corridorstringConditionalRequired for fiat transactions. Corridor: "uae", "ksa"

​
Response

{
  "id": "quote_1234567890",
  "type": "payin",
  "source_currency": "AED",
  "source_network": null,
  "source_amount": 50000,
  "destination_currency": "USDT",
  "destination_network": "ethereum",
  "destination_amount": "479.50",
  "exchange_rate": "0.009590",
  "fees": {
    "platform_fee": "20.50",
    "network_fee": "0.00"
  },
  "total_fee": "20.50",
  "expires_at": "2026-04-09T14:33:00Z",
  "created_at": "2026-04-09T14:30:00Z"
}

​
Response Fields

FieldTypeDescription
idstringUnique quote identifier. Use this in pay-in, payout, and bridge requests.
typestringThe transaction type specified in the request.
source_currencystringSource currency code.
source_networkstring | nullSource blockchain network (null for fiat).
source_amountinteger | stringAmount in source currency (fiat as integer, stablecoin as string).
destination_currencystringDestination currency code.
destination_networkstring | nullDestination blockchain network (null for fiat).
destination_amountinteger | stringAmount in destination currency (fiat as integer, stablecoin as string).
exchange_ratestringConversion rate (destination per source unit).
feesobjectPlatform and network fees breakdown.
total_feestring | integerCombined fee amount.
expires_atstringISO 8601 timestamp when quote expires (3 minutes from creation).
created_atstringISO 8601 timestamp of quote creation.

​
Examples

​
Fiat to Stablecoin (AED → USDT)

Request a quote to convert 500 AED to USDT on Ethereum: 
curl -X POST https://api.thiqwave.com/v1/quotes \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "payin",
    "source_currency": "AED",
    "destination_currency": "USDT",
    "destination_network": "ethereum",
    "amount": 50000,
    "corridor": "uae"
  }'

​
Stablecoin to Fiat (USDC → AED)

Request a quote to convert 500 USDC to AED: 
curl -X POST https://api.thiqwave.com/v1/quotes \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "payout",
    "source_currency": "USDC",
    "source_network": "polygon",
    "destination_currency": "AED",
    "amount": "500.00",
    "corridor": "uae"
  }'

​
Notes

  • Quotes expire after 3 minutes. Plan to use the quote_id immediately.
  • Use the quote_id from the response in subsequent pay-in, payout, and bridge requests.
  • Exchange rates and fees are locked for the duration of the quote.