/quote - Request a trade quote

Endpoint

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 identifieras provided in the /tokens endpoint.

Example request

A simple request to trade ETH.ETHto BTC.BTCmay omit the providerslist 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.

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
  }'