/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"`).
`buyAssset`	`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 -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
  }'

/tokens - Request supported tokens by a swap provider

/quote - Understanding the response

Join our Community

Any other questions? Book a Call