---
title: "Get a gateway quote."
method: GET
path: "/v2/get-quote"
tags: ["v2"]
---

# Get a gateway quote.

`GET /v2/get-quote`

Checks the available liquidity and provides a quote.

## Query parameters

- `srcChain` string, required
- `dstChain` string, required
- `sender` string
- `recipient` string, required
- `srcToken` string, required
- `dstToken` string, required
- `amount` string, required
- `gasRefill` string
- `slippage` string, required
- `strategyTarget` string
- `strategyMessage` string
- `affiliates` string

## Response `200`

Get a quote

- union — Gateway quote.
  - object
    - `onramp` GatewayOnrampQuoteV2, required — V2 onramp quote: identical to V1 plus a resolved `affiliates` list. Kept as a separate type so the V1 OpenAPI schema stays frozen.
      - `affiliateAddress` string, nullable — Affiliate address (V1-compatible field; first entry from `affiliates`).
      - `affiliates` ResolvedAffiliate[] — Resolved affiliate recipients and computed fees.
        - `address` string, required — Affiliate recipient address.
        - `fee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `dstChain` string, required — Destination chain
      - `dstToken` string, required — Destination token address
      - `estimatedTimeInSecs` integer, nullable — Estimated time in secs to complete the Order
      - `executionFees` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `feeBreakdown` GatewayOnrampFeeBreakdownV2, required
        - `affiliateFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `executionFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `layerzeroFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `protocolFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `solverFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `fees` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `gasRefill` string, nullable — Optional gas refill amount
      - `inputAmount` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `outputAmount` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `priceImpact` string, nullable — Price impact as a fraction, e.g. `"-0.05"` means 5% loss. Absent if no price feed is available.
      - `priceImpactUsd` string, nullable — Price impact in USD, excluding execution fee. E.g. `"-1.00"` means $1 loss. Absent if no price feed is available.
      - `recipient` string, required — Recipient address
      - `sender` string, nullable — Sender address
      - `signedQuoteData` string, required — The signed quote data to be used in create-order
      - `slippage` string, required — Slippage tolerance
      - `strategyAddress` string, nullable
      - `strategyMessage` string, nullable
      - `token` string, required — Token address
  - object
    - `offramp` GatewayOfframpQuoteV2, required
      - `affiliateAddress` string, nullable — Affiliate address (V1-compatible field; first entry from `affiliates`).
      - `affiliates` ResolvedAffiliate[] — Resolved affiliate recipients and computed fees (V2).
        - `address` string, required — Affiliate recipient address.
        - `fee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `estimatedTimeInSecs` integer, nullable — Estimated time in secs to complete the Order
      - `feeBreakdown` GatewayOfframpFeeBreakdownV2, required — V2 offramp fee breakdown. Same shape as V1 but each line carries USD.
        - `affiliateFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `fastestFeeRate` string, required
        - `inclusionFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `protocolFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
        - `solverFee` GatewayTokenAmountV2, required
          - `address` string, required
          - `amount` string, required
          - `chain` string, required
          - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `inputAmount` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `outputAmount` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `priceImpact` string, nullable — Price impact as a fraction, e.g. `"-0.05"` means 5% loss. Absent if no price feed is available.
      - `priceImpactUsd` string, nullable — Price impact in USD, excluding execution fee. E.g. `"-1.00"` means $1 loss. Absent if no price feed is available.
      - `recipient` string, required
      - `sender` string, nullable
      - `slippage` integer, required
      - `srcChain` string, required
      - `tokenAddress` string, required
      - `totalFeeUsd` string, required
      - `txTo` string, required
  - object
    - `tokenSwap` GatewayTokenSwapQuoteV2, required
      - `dstChain` string, required
      - `estimatedTimeInSecs` integer, required — Estimated time in secs to complete the Order
      - `fees` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `inputAmount` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `outputAmount` GatewayTokenAmountV2, required
        - `address` string, required
        - `amount` string, required
        - `chain` string, required
        - `usd` string, nullable — USD value of `amount`, absent if no price feed is available.
      - `priceImpact` string, nullable — Price impact as a fraction, e.g. `"-0.05"` means 5% loss. Absent if no price feed is available.
      - `priceImpactUsd` string, nullable — Price impact in USD, excluding execution fee. E.g. `"-1.00"` means $1 loss. Absent if no price feed is available.
      - `recipient` string, required
      - `sender` string, nullable
      - `slippage` integer, required
      - `srcChain` string, required
      - `txTo` string, required

## Other responses

- `400` — Get a quote error

## Changes

- **2026-05-26** `ca0ef15d5879` — 2 breaking, 2 warning, 2 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11` to the `details/oneOf[#/components/schemas/GatewayErrorDetailsV2]/` response property `oneOf` list for the response status `400`
  - added the new `AFFILIATE_FEES_NOT_SUPPORTED_FOR_ROUTE` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV2Variants]/` response property for the response status `400`
  - added the new `UNKNOWN` enum value to the `code/oneOf[#/components/schemas/GatewayErrorCodeV2Variants]/` response property for the response status `400`
  - …2 more
- **2026-05-19** `f38ecb0aac58` — 3 breaking, 25 info
  - added `#/components/schemas/GatewayErrorCode, #/components/schemas/GatewayErrorCodeV2Variants` to the `code` response property `oneOf` list for the response status `400`
  - added `#/components/schemas/GatewayErrorDetailsV2` to the `details` response property `oneOf` list for the response status `400`
  - the `code` response's property type/format changed from `string`/`` to ``/`` for status `400`
  - removed the `DISABLED_CHAIN` enum value from the `code` response property for the response status `400`
  - …24 more
- **2026-05-06** `162bab886181` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bob-collective/apis/bob-gateway-api/changes/v2/get-quote/get.md)

---

[API](https://skmtc.dev/bob-collective/apis/bob-gateway-api.md) · [All operations](https://skmtc.dev/bob-collective/apis/bob-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bob-collective/bob-gateway-api/revisions/5a00610487e4/schema)