Skip to main content
GET
/
provider
/
rates
/
{token}
/
{fiat}
Get market rate
curl --request GET \
  --url https://api.paycrest.io/v1/provider/rates/{token}/{fiat} \
  --header 'API-Key: <api-key>'
{
  "status": "success",
  "message": "Operation successful",
  "data": {
    "buy": {
      "marketRate": "<string>",
      "minimumRate": "<string>",
      "maximumRate": "<string>",
      "position": {
        "bestPublicRate": "<string>",
        "yourEffectiveRate": "<string>",
        "deltaVsBest": "<string>"
      }
    },
    "sell": {
      "marketRate": "<string>",
      "minimumRate": "<string>",
      "maximumRate": "<string>",
      "position": {
        "bestPublicRate": "<string>",
        "yourEffectiveRate": "<string>",
        "deltaVsBest": "<string>"
      }
    }
  }
}
Retrieve the market rate for a token and fiat pair (v1 path; same response shape as GET /v2/provider/rates/{token}/{fiat}). The data object contains buy and sell sides when applicable, each with marketRate, minimumRate, and maximumRate (strings). The older flat fields marketBuyRate / marketSellRate / minimumRate / maximumRate at the top level are no longer returned. The optional position object (bestPublicRate, yourEffectiveRate, deltaVsBest) applies to this v1 path with the same semantics as the v2 route. See Get Market Rate (v2) for full position documentation.

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 (same shape as GET /v2/provider/rates/{token}/{fiat}).