Indicative Quotes - Bebop API Docs

An indicative quote is a price estimate from the current market maker price levels. Bebop does not send the request to market makers, does not store the quote, and does not return an order to sign. Use indicative quotes to show prices, compare routes, or size trades. Request a firm quote from /v3/quote before you execute.

Indicative quotes require enablement on your API key. Contact support to get access. They are available on EVM chains. Solana is not supported.

Request indicative quotes

Send a POST request to /v3/indicative-quote. Each item in requests is one trade to price. The top-level fields apply to every item. For all fields, see the Indicative Quote reference.

curl -X POST "https://api.bebop.xyz/pmm/ethereum/v3/indicative-quote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taker_address": "0xYOUR_ADDRESS",
    "requests": [
      {
        "sell_tokens": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "buy_tokens": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "sell_amounts": "1000000000000000000"
      },
      {
        "sell_tokens": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "buy_tokens": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "buy_amounts": "5000000000000000000"
      }
    ]
  }'

Read the response

The response has one entry in quotes for each item that Bebop can price, and one entry in errors for each item that it cannot price. A batch can return both. Use errors[].index to find the request item that failed.

{
  "requestId": "91da6a22-4c97-42af-9a6f-7019582c5e06",
  "chainId": 1,
  "taker": "0x5Bad996643a924De21b6b2875c85C33F3c5bBcB6",
  "receiver": "0x5Bad996643a924De21b6b2875c85C33F3c5bBcB6",
  "quotes": [
    {
      "quoteId": "121-95405455895649992079278991168367123573",
      "gasFee": { "native": "0", "usd": 0.0 },
      "buyTokens": {
        "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48": {
          "amount": "2366389922",
          "decimals": 6,
          "priceUsd": 0.999531,
          "symbol": "USDC",
          "minimumAmount": "2366389922",
          "amountBeforeFee": "2366389922"
        }
      },
      "sellTokens": {
        "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": {
          "amount": "1000000000000000000",
          "decimals": 18,
          "priceUsd": 2369.28,
          "symbol": "WETH"
        }
      }
    }
  ],
  "errors": []
}

The quoteId identifies the request in logs and support. You cannot use it to place an order.

Limits

Send 1 to 25 items in requests. A larger batch returns one top-level error and no quotes.
Each item counts as one request against your rate limit. The limit is shared with /v3/quote. An item over the limit returns an error in errors.
An indicative price is not a commitment. A firm quote for the same trade can be different, mostly for large sizes or when the market moves fast.