---
title: "Get market rate"
method: GET
path: "/provider/rates/{token}/{fiat}"
tags: ["Provider"]
---

# Get market rate

`GET /provider/rates/{token}/{fiat}`

## Path parameters

- `token` string, required
- `fiat` string, required

## Response `200`

Market rate

- object
  - `status` string
  - `message` string
  - `data` object — Market rate bounds split by side. Either or both of `buy` and `sell` may be present depending on corridor configuration.
    - `buy` MarketRateSide — Tolerance band for one side (buy or sell) of the market rate.
      - `marketRate` string — Reference market rate for this side (fiat per crypto).
      - `minimumRate` string — Minimum allowed rate for this side.
      - `maximumRate` string — Maximum allowed rate for this side.
      - `position` MarketPosition — Provider's rate standing versus the best public peer in the same corridor. Omitted when no qualifying public offers exist or the provider has no effective rate for the corridor (backward compatible).
        - `bestPublicRate` string — Best rate among enabled non-testnet public peers for this side (highest effective sell rate; lowest effective buy rate).
        - `yourEffectiveRate` string — The provider's own effective rate for this corridor and side.
        - `deltaVsBest` string — `yourEffectiveRate − bestPublicRate`. For **sell** a positive delta means you offer a higher rate than the best peer (more competitive). For **buy** a negative delta means you offer a lower rate than the best peer (more competitive).
    - `sell` MarketRateSide — Tolerance band for one side (buy or sell) of the market rate.
      - `marketRate` string — Reference market rate for this side (fiat per crypto).
      - `minimumRate` string — Minimum allowed rate for this side.
      - `maximumRate` string — Maximum allowed rate for this side.
      - `position` MarketPosition — Provider's rate standing versus the best public peer in the same corridor. Omitted when no qualifying public offers exist or the provider has no effective rate for the corridor (backward compatible).
        - `bestPublicRate` string — Best rate among enabled non-testnet public peers for this side (highest effective sell rate; lowest effective buy rate).
        - `yourEffectiveRate` string — The provider's own effective rate for this corridor and side.
        - `deltaVsBest` string — `yourEffectiveRate − bestPublicRate`. For **sell** a positive delta means you offer a higher rate than the best peer (more competitive). For **buy** a negative delta means you offer a lower rate than the best peer (more competitive).

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

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