Check PeerPesa Fiat and Crypto Conversion Rates

PeerPesa provides indicative conversion rates so you can estimate the value of a ramp before committing. Rates are not locked until you create a quote, and quotes remain valid for 30 minutes. Use this endpoint to preview pricing for your users before generating a locked quote.

Rates returned by this endpoint are indicative only and may change without notice. To lock a rate for 30 minutes, create a quote via POST /quotes.

Get conversion rate

GET /rates?type={type}&network={network}&asset={asset}&fiat_currency={fiat_currency}

Retrieve the current conversion rate for an onramp (fiat to crypto) or offramp (crypto to fiat) pair.

Query parameters

string

required

Direction of the ramp. Must be one of: onramp, offramp.

string

required

Blockchain network. Must be one of: stellar, celo.

string

required

Crypto asset code. Supported values per network:

stellar: XLM, USDC
celo: CELO, USDT, USDC, CUSD

string

required

Fiat currency code. Supported values: KES, TZS, NGN, ZAR, ZMW.

Request examples

# Onramp rate: KES to USDC on Stellar
curl -X GET "https://api.peerpesa.co/v1/rates?type=onramp&network=stellar&asset=USDC&fiat_currency=KES" \
  -H "Authorization: Bearer <access_token>"

# Offramp rate: USDT to NGN on Celo
curl -X GET "https://api.peerpesa.co/v1/rates?type=offramp&network=celo&asset=USDT&fiat_currency=NGN" \
  -H "Authorization: Bearer <access_token>"

// Onramp rate: KES to USDC on Stellar
fetch("https://api.peerpesa.co/v1/rates?type=onramp&network=stellar&asset=USDC&fiat_currency=KES", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <access_token>",
    "Content-Type": "application/json"
  }
});

// Offramp rate: USDT to NGN on Celo
fetch("https://api.peerpesa.co/v1/rates?type=offramp&network=celo&asset=USDT&fiat_currency=NGN", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <access_token>",
    "Content-Type": "application/json"
  }
});

Response example

{
  "type": "onramp",
  "network": "stellar",
  "asset": "USDC",
  "fiat_currency": "KES",
  "rate": "129.45",
  "inverse_rate": "0.007725",
  "updated_at": "2024-06-12T09:30:00Z"
}

Response fields

string

required

The ramp direction requested. One of: onramp, offramp.

string

required

The blockchain network identifier. One of: stellar, celo.

string

required

The crypto asset code (e.g. USDC, USDT, CUSD).

string

required

The fiat currency code (e.g. KES, NGN).

string

required

The conversion rate as a decimal string. For an onramp, this is the amount of fiat per one unit of crypto. For an offramp, it is the amount of fiat received per one unit of crypto. The exact semantics depend on the type and asset pair.

string

required

The inverse of the quoted rate as a decimal string.

string

required

ISO 8601 UTC timestamp indicating when this rate was last refreshed.

Error responses

Possible error codes for this endpoint include:

HTTP status	Error code	Meaning
400	`invalid_request`	A required query parameter is missing or malformed.
401	`unauthorized`	Access token is missing or expired.
422	`unsupported_pair`	The requested asset, fiat currency, network, or type combination is not supported.
429	`rate_limited`	Too many requests. Retry after the rate limit window resets.

​Get conversion rate

​Query parameters

​Request examples

​Response example

​Response fields

​Error responses

Get conversion rate

Query parameters

Request examples

Response example

Response fields

Error responses