> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usetapp.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Conversion Rate

> Get the live conversion rate for a token to fiat corridor at a given amount.

Retrieve the live conversion rate, fees, and ETAs for converting stablecoins to local fiat currency. This endpoint is public and requires no authentication.
The returned rate is the executable corridor rate after Rails applies the flat 0.5% B2B provider fee on top of the upstream settlement quote.

### Path Parameters

<ParamField path="token" type="string" required>
  The stablecoin type (`USDC` or `USDT`).
</ParamField>

<ParamField path="amount" type="string" required>
  The amount of stablecoin to convert (e.g. `"100"`).
</ParamField>

<ParamField path="fiat" type="string" required>
  The target fiat currency code (`NGN`, `KES`, `UGX`, `TZS`, `MWK`).
</ParamField>

### Response

Returns the standard response envelope wrapping rate quote details.

<ResponseField name="status" type="string">
  Response state (`success`).
</ResponseField>

<ResponseField name="data" type="object">
  Rate payload.

  <ResponseField name="rate" type="string">
    The executable exchange rate after the 0.5% provider fee.
  </ResponseField>

  <ResponseField name="rateId" type="string">
    A server-locked quote id. Pass it as `rateId` to
    [Create Order](/api-reference/endpoint-create-order) instead of a raw
    `rate` — the order is then created at this exact rate. Expires in 15 minutes.
  </ResponseField>

  <ResponseField name="token" type="string">The token symbol.</ResponseField>
  <ResponseField name="currency" type="string">The fiat currency code.</ResponseField>

  <ResponseField name="expiresAt" type="string">
    ISO-8601 expiry of the `rateId`.
  </ResponseField>
</ResponseField>

***

### Example Payloads

<RequestExample>
  ```http Get Rate theme={null}
  GET /v1/rates/USDC/100/KES HTTP/1.1
  Host: b2b.usetapp.xyz
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "status": "success",
    "message": "Rate fetched successfully",
    "data": {
      "rate": "1374.6",
      "rateId": "c3f87453-c74b-40ed-9e8a-ed5cc39935af",
      "token": "USDC",
      "currency": "KES",
      "expiresAt": "2026-07-05T19:17:36Z"
    }
  }
  ```
</ResponseExample>