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"
}'
const response = await fetch('https://api.thiqwave.com/v1/quotes', {
method: 'POST',
headers: {
'X-API-Key': 'your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
type: 'payin',
source_currency: 'AED',
destination_currency: 'USDT',
destination_network: 'ethereum',
amount: 50000,
corridor: 'uae',
}),
});
const quote = await response.json();
console.log(quote);
import requests
response = requests.post(
'https://api.thiqwave.com/v1/quotes',
headers={'X-API-Key': 'your_api_key'},
json={
'type': 'payin',
'source_currency': 'AED',
'destination_currency': 'USDT',
'destination_network': 'ethereum',
'amount': 50000,
'corridor': 'uae',
}
)
quote = response.json()
print(quote)
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Transaction type: "transfer" (recommended), "payin", "payout", "bridge", or "swap" |
source_currency | string | Yes | Fiat code (AED, USD, EUR, GBP) or stablecoin (USDT, USDC) |
source_network | string | Conditional | Required when source is a stablecoin. Blockchain network: ethereum, avalanche, arbitrum, base, polygon, tron, stellar, solana, xrpl, algorand, sui |
destination_currency | string | Yes | Fiat code or stablecoin |
destination_network | string | Conditional | Required when destination is a stablecoin |
amount | integer (fiat) or string (stablecoin) | Yes | Fiat in smallest currency unit (e.g., 50000 AED fils); stablecoin in human-readable format (e.g., "500.00") |
corridor | string | Conditional | Required for fiat transactions. Corridor: "uae" |
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
| Field | Type | Description |
|---|---|---|
id | string | Unique quote identifier. Use this in pay-in, payout, and bridge requests. |
type | string | The transaction type specified in the request. |
source_currency | string | Source currency code. |
source_network | string | null | Source blockchain network (null for fiat). |
source_amount | integer | string | Amount in source currency (fiat as integer, stablecoin as string). |
destination_currency | string | Destination currency code. |
destination_network | string | null | Destination blockchain network (null for fiat). |
destination_amount | integer | string | Amount in destination currency (fiat as integer, stablecoin as string). |
exchange_rate | string | Conversion rate (destination per source unit). |
fees | object | Platform and network fees breakdown. |
total_fee | string | integer | Combined fee amount. |
expires_at | string | ISO 8601 timestamp when quote expires (3 minutes from creation). |
created_at | string | ISO 8601 timestamp of quote creation. |
Examples
Transfer Quote (Recommended)
Request a transfer quote for AED to USDC on Sui — the unified quote type that works for any source/destination combination:curl -X POST https://api.thiqwave.com/v1/quotes \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "transfer",
"source_currency": "AED",
"destination_currency": "USDC",
"destination_network": "sui",
"amount": "1000.00",
"corridor": "uae"
}'
const response = await fetch('https://api.thiqwave.com/v1/quotes', {
method: 'POST',
headers: {
'X-API-Key': 'your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
type: 'transfer',
source_currency: 'AED',
destination_currency: 'USDC',
destination_network: 'sui',
amount: '1000.00',
corridor: 'uae',
}),
});
const quote = await response.json();
import requests
response = requests.post(
'https://api.thiqwave.com/v1/quotes',
headers={'X-API-Key': 'your_api_key'},
json={
'type': 'transfer',
'source_currency': 'AED',
'destination_currency': 'USDC',
'destination_network': 'sui',
'amount': '1000.00',
'corridor': 'uae',
}
)
quote = response.json()
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"
}'
const response = await fetch('https://api.thiqwave.com/v1/quotes', {
method: 'POST',
headers: {
'X-API-Key': 'your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
type: 'payin',
source_currency: 'AED',
destination_currency: 'USDT',
destination_network: 'ethereum',
amount: 50000,
corridor: 'uae',
}),
});
const quote = await response.json();
import requests
response = requests.post(
'https://api.thiqwave.com/v1/quotes',
headers={'X-API-Key': 'your_api_key'},
json={
'type': 'payin',
'source_currency': 'AED',
'destination_currency': 'USDT',
'destination_network': 'ethereum',
'amount': 50000,
'corridor': 'uae',
}
)
quote = response.json()
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"
}'
const response = await fetch('https://api.thiqwave.com/v1/quotes', {
method: 'POST',
headers: {
'X-API-Key': 'your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
type: 'payout',
source_currency: 'USDC',
source_network: 'polygon',
destination_currency: 'AED',
amount: '500.00',
corridor: 'uae',
}),
});
const quote = await response.json();
import requests
response = requests.post(
'https://api.thiqwave.com/v1/quotes',
headers={'X-API-Key': 'your_api_key'},
json={
'type': 'payout',
'source_currency': 'USDC',
'source_network': 'polygon',
'destination_currency': 'AED',
'amount': '500.00',
'corridor': 'uae',
}
)
quote = response.json()
Notes
- Quotes expire after 3 minutes. Plan to use the
quote_idimmediately. - Use the
quote_idfrom the response in subsequent transfer, pay-in, payout, and bridge requests. - Exchange rates and fees are locked for the duration of the quote.