Skip to main content
Every transaction in Thiqwave starts with a quote. A quote locks in your exchange rate, fees, and destination amount for 3 minutes. This ensures you always know the exact cost before committing.

​
Why Quotes?

Markets move. Rates shift. A quote guarantees you won’t face surprise slippage or fees when you execute. Get a quote, execute within 3 minutes, and your transaction settles at the promised rate.

​
Quote Lifecycle

Requested → Locked → Executed / Expired
StateDescription
requestedQuote created, awaiting execution
lockedQuote is active and guaranteed for 3 minutes
executedTransaction initiated with this quote
expired3 minutes elapsed; quote no longer valid

​
Request a Quote

To request a quote, POST to /v1/quotes: 
curl -X POST https://api.thiqwave.com/v1/quotes \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "AED",
    "destination_currency": "USDC",
    "amount": "10000",
    "destination_network": "polygon",
    "corridor": "uae",
    "recipient_type": "wallet"
  }'

​
Quote Response

{
  "id": "quote_abc123xyz",
  "source_currency": "AED",
  "destination_currency": "USDC",
  "source_amount": "10000",
  "destination_amount": "27.20",
  "exchange_rate": "0.272",
  "fees": {
    "platform_fee": 10,
    "network_fee": 5
  },
  "total_fee": 15,
  "expires_at": "2026-04-08T12:34:00Z",
  "valid_for_seconds": 180,
  "corridor": "uae",
  "destination_network": "polygon"
}
Key Fields:
  • id: Unique quote identifier. Use this to execute the transaction.
  • source_amount: Amount you send (in smallest currency unit)
  • destination_amount: Amount recipient receives (human-readable stablecoin format)
  • exchange_rate: Rate applied for this quote
  • fees: Breakdown of all fees (platform, network, etc.)
  • total_fee: Sum of all fees
  • expires_at: Timestamp when quote expires
  • valid_for_seconds: Always 180 seconds (3 minutes)

​
Amount Format

Amounts follow this format by currency:
CurrencyFormatExample
AEDFils (1/100)10,000 fils = 100 AED
SARHalalas (1/100)10,000 halalas = 100 SAR
USDT / USDCHuman-readable”272.50” = 272.50 USDT
USDCents10,000 cents = 100 USD

​
Execute a Transaction

Use the quote ID when initiating a payout, pay-in, or on-chain FX transaction: 
curl -X POST https://api.thiqwave.com/v1/payouts \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "quote_abc123xyz",
    "recipient": {
      "wallet_address": "0x742d35Cc6634C0532925a3b844Bc92d426b4e4f7"
    }
  }'

​
Quote Expiry & Renewal

Quotes expire after 3 minutes. If you miss the window:
  1. Request a new quote
  2. Rates may have changed
  3. Execute with the new quote ID
There’s no penalty for expired quotes—just request another one.
Build a timer into your UI to show users when their quote expires. Refresh automatically or prompt the user to re-quote before execution.

​
Fee Breakdown

Fees vary by transaction type and corridor:
  • Platform Fee: Thiqwave’s charge for settlement
  • Network Fee: Blockchain gas or fiat rail costs
  • Exchange Fee: Spread on FX transactions
All fees are included in the destination_amount. No hidden charges.

​
Rate Locks & Market Conditions

Quotes are locked rates. However:
  • If market conditions change drastically, quote execution may fail and auto-retry with a new quote
  • Slippage is not typical for Thiqwave transactions (we quote destination amounts, not indicative rates)
  • Network congestion may delay settlement but won’t affect the quoted rate

​
Next Steps

Payouts

Bridging

On-chain FX

Quotes API Reference