# /quote - Request a trade quote

### Endpoint <a href="#endpoint" id="endpoint"></a>

**Method:** `POST` \
**URL:** `https://crunchy.dorito.club/api/quote`

### Request parameters

```
{
  "sellAsset": "string",
  "buyAsset": "string",
  "sellAmount": "string",
  "providers": [
    "string"
  ],
  "sourceAddress": "string",
  "destinationAddress": "string",
  "slippage": 100,
  "affiliate": "string",
  "affiliateFee": 88,
  "includeTx": true
}
```

Here's a detailed description of the different parameters:

| Parameter            | Type      | Required | Description                                            |
| -------------------- | --------- | -------- | ------------------------------------------------------ |
| `sellAsset`          | `string`  | ✅ Yes    | The asset being sold (e.g. `"ETH.ETH"`).               |
| `buyAsset`           | `string`  | ✅ Yes    | The asset being bought (e.g. `"BTC.BTC"`).             |
| `sellAmount`         | `string`  | ✅ Yes    | Amount in basic units (decimals separated with a dot). |
| `providers`          | `array`   | ❌ No     | Limits the possible liquidity providers.               |
| `sourceAddress`      | `string`  | ✅ Yes    | Address of the sender.                                 |
| `destinationAddress` | `string`  | ✅ Yes    | Address of the recipient.                              |
| `slippage`           | `number`  | ❌ No     | Max slippage in percentage (5 = 5%).                   |
| `affiliate`          | `string`  | ❌ No     | Affiliate address for revenue sharing.                 |
| `affiliateFee`       | `number`  | ❌ No     | Fee percentage in basis points (50= 0.5%).             |
| `includeTx`          | `boolean` | ❌ No     | Include transaction details in the response.           |

**Note:** Asset names for `sellAsset` and `buyAsset` should follow the following nomenclature:

* Chain.Ticker (e.g., `"BTC.BTC"` or `"ARB.ETH"`)
* Chain.Ticker-ContractAddress (e.g., `"ETH.USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"`)

This is the `identifier`as provided in the [`/tokens`](/dkit-by-eldorito/dkit-api/tokens-request-supported-tokens-by-a-swap-provider.md) endpoint.

### Example request <a href="#example-request" id="example-request"></a>

A simple request to trade `ETH.ETH`to `BTC.BTC`may omit the `providers`list if you can manage them in the response, but should include the amount, the involved addresses and slippage settings.

The expiration time returned by the endpoint is an estimation. We recommend requesting a new quote at least every minute if the trade has not been executed yet.

{% tabs %}
{% tab title="cURL" %}

```
curl -X POST "https://crunchy.dorito.club/api/quote" \
  -H "Content-Type: application/json" \
  -d '{
    "sellAsset": "ETH.ETH",
    "buyAsset": "BTC.BTC",
    "sellAmount": "0.1",
    "sourceAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "destinationAddress": "357a3So9CbsNfBBgFYACGvxxS6tMaDoa1P",
    "slippage": 10,
    "includeTx": true
  }'
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eldorito.club/dkit-by-eldorito/dkit-api/quote-request-a-trade-quote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.