Skip to main content
GET
/
provider
/
rates
/
{token}
/
{fiat}
Get market rate
curl --request GET \
  --url https://api.paycrest.io/v2/provider/rates/{token}/{fiat} \
  --header 'API-Key: <api-key>'
{
  "status": "success",
  "message": "Operation successful",
  "data": {
    "buy": {
      "marketRate": "<string>",
      "minimumRate": "<string>",
      "maximumRate": "<string>"
    },
    "sell": {
      "marketRate": "<string>",
      "minimumRate": "<string>",
      "maximumRate": "<string>"
    }
  }
}
Returns buy and sell market rate bands (reference rate plus min/max tolerance) for a token/fiat pair. Use this to validate whether a sender-provided rate on order creation is within allowed bounds.

​
Response shape (data)

FieldTypeDescription
buyobject (optional)Buy-side band: marketRate, minimumRate, maximumRate
sellobject (optional)Sell-side band: marketRate, minimumRate, maximumRate
Numeric values are returned as strings (decimal). Either side may be omitted depending on corridor configuration.
GET /v1/provider/rates/{token}/{fiat} uses the same response shape as this v2 route.

Authorizations

​
API-Key
string
header
required

Path Parameters

​
token
string
required
​
fiat
string
required

Response

Market rate

​
status
string
Example:

"success"

​
message
string
Example:

"Operation successful"

​
data
object

Market rate bounds split by side. Either or both of buy and sell may be present depending on corridor configuration.