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

# Quotes

Use quotes to compare provider routing before you create an order.

> **Why this page matters**
> Quotes are where RampHub shows its value: one request, multiple provider paths, and a single best route you can trust by default.

## Buy quotes

Buy quotes accept `fiatAmount` and should not include `tokenAmount`.

```bash theme={null}
curl -X POST "https://api.ramphub.io/api/developer/quotes" \
  -H "x-api-key: rh_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "side": "buy",
    "fiatAmount": 15000,
    "fiatCurrency": "NGN",
    "asset": "USDT",
    "chain": "base"
  }'
```

## Sell quotes

Sell quotes accept `tokenAmount` and should not include `fiatAmount`.

```bash theme={null}
curl -X POST "https://api.ramphub.io/api/developer/quotes" \
  -H "x-api-key: rh_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "side": "sell",
    "tokenAmount": 10,
    "fiatCurrency": "NGN",
    "asset": "USDT",
    "chain": "base"
  }'
```

## Response shape

The response returns `bestQuote` plus the full `quotes` list for comparison.

```json theme={null}
{
  "side": "buy",
  "asset": "USDT",
  "chain": "base",
  "comparisonInput": 15000,
  "comparisonInputSource": "fiatAmount",
  "bestQuote": {
    "provider": "Paycrest",
    "rate": 1385.95,
    "estimatedOutput": 10.801255
  },
  "quotes": []
}
```

## Rules

* Always include `asset`, `chain`, and `fiatCurrency`.
* Use `bestQuote` as the default route.
* Keep `quotes` for comparison only.