---
title: "Get swap rates"
method: GET
path: "/v1/swap/rates"
tags: ["Swaps"]
---

# Get swap rates

`GET /v1/swap/rates`

Get informative swap rates from all available swappers. This does not create a transaction.

## Query parameters

- `sellAssetId` string, required
- `buyAssetId` string, required
- `sellAmountCryptoBaseUnit` string — Exact amount of the sell asset to send, in base units. Required unless buyAmountCryptoBaseUnit is given.
- `buyAmountCryptoBaseUnit` string — Exact amount of the buy asset to receive, in base units. Each rate returns the sell amount needed to get it. Mutually exclusive with sellAmountCryptoBaseUnit; swappers that cannot quote an exact output come back with an ExactOutputNotSupported error.
- `slippageTolerancePercentageDecimal` string

## Headers

- `X-Partner-Code` string

## Response `200`

Swap rates

- RateResponse
  - `rates` object[], required
    - `swapperName` string, required
    - `rate` string, required
    - `buyAmountCryptoBaseUnit` string, required
    - `sellAmountCryptoBaseUnit` string, required
    - `steps` number, required
    - `allowanceContract` string — First-hop approval spender for the sell token. Non-empty means executing this swapper pulls the sell token from an approved allowance - clients wanting to check or set an allowance manually before quoting can use it directly. Empty or absent means no approval is involved.
    - `estimatedExecutionTimeMs` number
    - `priceImpactPercentageDecimal` string
    - `affiliateBps` string, required — Total on-chain fee in bps.
    - `partnerBps` string — Partner share in bps.
    - `shapeshiftBps` string, required — ShapeShift platform fee in bps.
    - `networkFeeCryptoBaseUnit` string
    - `error` object
      - `code` string, required
      - `message` string, required
  - `timestamp` number, required
  - `expiresAt` number, required

## Other responses

- `400` — Invalid request
- `429` — Rate limit exceeded. Includes Retry-After header with seconds until reset.
- `500` — Internal server error

---

[API](https://skmtc.net/shapeshift/apis/shapeshift-public-api.md) · [All operations](https://skmtc.net/shapeshift/apis/shapeshift-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shapeshift/shapeshift-public-api/revisions/6ffb6a8fd74a/schema)