Get token rate (v2)

curl --request GET \
  --url https://api.paycrest.io/v2/rates/{network}/{from}/{amount}/{to}

{
  "status": "success",
  "message": "Operation successful",
  "data": {
    "buy": {
      "rate": "<string>",
      "providerIds": [
        "<string>"
      ],
      "orderType": "<string>",
      "refundTimeoutMinutes": 123
    },
    "sell": {
      "rate": "<string>",
      "providerIds": [
        "<string>"
      ],
      "orderType": "<string>",
      "refundTimeoutMinutes": 123
    }
  }
}

General

Get Token Rate

Public quote on a specific network. Returns buy and/or sell quotes, order type, and refund timeout.

Token + fiat: each of from / to is either an enabled fiat currency code or an enabled crypto (token) symbol on network. Exactly one must be fiat and one crypto (.../USDT/100/NGN and .../NGN/100/USDT are equivalent). amount is the crypto notional. Rates are fiat per 1 token for each side. from and to cannot both be crypto.

Ambiguous segment: if a path value matches both an enabled fiat code and an enabled crypto symbol on that network (e.g. same string), the request returns 400 unless from_source and/or to_source is set to fiat or crypto to pick the leg.

Fiat + fiat: both segments are fiat codes. The quote bridges through USDC on the same network. amount is denominated in from fiat. sell is destination fiat per 1 unit of from fiat (buy USDC with from, sell USDC for to). buy is from fiat per 1 unit of to fiat (inverse corridor; buy USDC with to, sell USDC for from)—asymmetric from sell, not a simple reciprocal.

Path order does not imply trade direction for token/fiat pairs; omitting side returns both sides when available.

For the legacy single-number response, use GET /v1/rates/{token}/{amount}/{fiat} with optional network query.

GET

rates

{network}

{from}

{amount}

{to}

Get token rate (v2)

curl --request GET \
  --url https://api.paycrest.io/v2/rates/{network}/{from}/{amount}/{to}

{
  "status": "success",
  "message": "Operation successful",
  "data": {
    "buy": {
      "rate": "<string>",
      "providerIds": [
        "<string>"
      ],
      "orderType": "<string>",
      "refundTimeoutMinutes": 123
    },
    "sell": {
      "rate": "<string>",
      "providerIds": [
        "<string>"
      ],
      "orderType": "<string>",
      "refundTimeoutMinutes": 123
    }
  }
}

Get buy and/or sell quotes on a specific network—either a token + fiat pair or a fiat + fiat corridor (via USDC). This is the recommended public rates URL for v2 integrations.

The legacy endpoint GET /v1/rates/{token}/{amount}/{fiat} (optional network query) returns a single numeric data field. The v2 path below returns a structured buy / sell payload.

Path parameters

Parameter	Description
`network`	Network id: `ethereum`, `base`, `bnb-smart-chain`, `lisk`, `scroll`, `celo`, `arbitrum-one`, `polygon`, `asset-chain`
`from`	Fiat currency code or token symbol on `network` (paired with `to`)
`amount`	For token + fiat: crypto (token) notional. For fiat + fiat: amount in `from` fiat.
`to`	Fiat currency code or token symbol on `network` (paired with `from`)

Token + fiat: exactly one fiat and one token (.../USDT/100/NGN ≡ .../NGN/100/USDT). from/to cannot both be tokens. Path order does not imply trade direction—use side or read data.buy / data.sell for onramp vs offramp display. Fiat + fiat: both are fiat codes; the server quotes through USDC on the same network. sell.rate = to per 1 from. buy.rate = from per 1 to (inverse corridor, not the reciprocal of sell—each side uses the appropriate leg bid/ask).

Query parameters

Parameter	Required	Description
`side`	No	`buy` or `sell` to return only that side. Omit to receive both when available.
`from_source`	No	If `from` matches both a fiat currency and a crypto asset on the network, set to `fiat` or `crypto`. Omit when unambiguous.
`to_source`	No	If `to` matches both a fiat currency and a crypto asset on the network, set to `fiat` or `crypto`. Omit when unambiguous.
`provider_id`	No	Exactly 8 alphabetic characters (`A–Z`, `a–z`) to pin the quote to one provider.

Example

# Both buy and sell quotes on Base (token then fiat)
GET https://api.paycrest.io/v2/rates/base/USDT/100/NGN

# Same pair with fiat then token
GET https://api.paycrest.io/v2/rates/base/NGN/100/USDT

# Sell side only (typical for offramp display)
GET https://api.paycrest.io/v2/rates/base/USDT/100/NGN?side=sell

# Specific provider
GET https://api.paycrest.io/v2/rates/base/USDT/100/NGN?provider_id=AbCdEfGh

Success response (`data`)

Each populated side includes:

Field	Type	Description
`rate`	string	For token+fiat: fiat per crypto. For fiat+fiat: see path rules above (`sell` = `to` per `from`, `buy` = `from` per `to`).
`providerIds`	string[]	Provider id(s) for the quote
`orderType`	string	e.g. `regular` or `otc`
`refundTimeoutMinutes`	integer	Minutes until automatic refund for that flow

{
  "status": "success",
  "message": "Rate fetched successfully",
  "data": {
    "buy": {
      "rate": "1498.25",
      "providerIds": ["AbCdEfGh"],
      "orderType": "regular",
      "refundTimeoutMinutes": 60
    },
    "sell": {
      "rate": "1500.50",
      "providerIds": ["AbCdEfGh"],
      "orderType": "regular",
      "refundTimeoutMinutes": 60
    }
  }
}

When side=buy or side=sell, only that key is present under data.

Errors

HTTP	Typical cause
400	Invalid `amount`, invalid `side`, invalid `from_source`/`to_source` (must be `fiat` or `crypto`), ambiguous segment without disambiguation, invalid `provider_id`, unsupported asset on network, or conversion rules (e.g. stable only to its base fiat)
404	No provider available for the amount/currency/network
503	Banking/mobile network issues affecting providers for the currency
500	Internal error while resolving the rate

Rate resolution

Behavior matches the priority-queue–based resolution used when creating orders: the quote reflects provider selection and validation for the requested side (buy vs sell). Path segment order (from / to) does not select direction—use ?side=, or read data.sell for offramp (crypto → fiat) display and data.buy for onramp (fiat → crypto) before POST /v2/sender/orders. See also Get Token Rate (v1) for the legacy scalar response.

Path Parameters

network

enum<string>

required

Blockchain network identifier (lowercase in URL).

Available options:

ethereum,

base,

bnb-smart-chain,

lisk,

scroll,

celo,

arbitrum-one,

polygon,

asset-chain

from

string

required

Fiat code or token symbol on network (paired with to).

amount

string

required

For token+fiat pairs, the token notional. For fiat+fiat pairs, the amount in from fiat.

string

required

Fiat code or token symbol on network (paired with from).

Query Parameters

side

enum<string>

Return only the buy or sell quote. Omit for both sides.

Available options:

buy,

sell

from_source

enum<string>

When from matches both a fiat and a crypto asset on network, set to fiat or crypto to disambiguate. Ignored when from is unambiguous.

Available options:

fiat,

crypto

to_source

enum<string>

When to matches both a fiat and a crypto asset on network, set to fiat or crypto to disambiguate. Ignored when to is unambiguous.

Available options:

fiat,

crypto

provider_id

string

Optional. When set, limits the quote to this provider. Must be exactly 8 alphabetic characters (A–Z, a–z).

Pattern: ^[A-Za-z]{8}$

Response

Token rate quote(s)

status

string

Example:

"success"

message

string

Example:

"Operation successful"

data

object

Public token rate quote. Omit side to receive both buy and sell; use side=buy or side=sell for a single side.

Show child attributes

List Supported Tokens Get Markets

​Path parameters

​Query parameters

​Example

​Success response (data)

​Errors

​Rate resolution

Path Parameters

Query Parameters

Response

Path parameters

Query parameters

Example

Success response (`data`)

Errors

Rate resolution