> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thiqwave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Quote

> Request a real-time quote for any value transfer.

## 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

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```javascript JavaScript theme={null}
  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);
  ```

  ```python Python theme={null}
  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)
  ```
</CodeGroup>

### 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

```json theme={null}
{
  "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:

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```javascript JavaScript theme={null}
  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();
  ```

  ```python Python theme={null}
  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()
  ```
</CodeGroup>

### Fiat to Stablecoin (AED → USDT)

Request a quote to convert 500 AED to USDT on Ethereum:

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```javascript JavaScript theme={null}
  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();
  ```

  ```python Python theme={null}
  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()
  ```
</CodeGroup>

### Stablecoin to Fiat (USDC → AED)

Request a quote to convert 500 USDC to AED:

<CodeGroup>
  ```bash cURL theme={null}
  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"
    }'
  ```

  ```javascript JavaScript theme={null}
  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();
  ```

  ```python Python theme={null}
  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()
  ```
</CodeGroup>

## Notes

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