Price quote API

Query our crypto-fiat conversion result for a given output, including our fees. This typically used to integrate us in an on/off-ramp comparator or aggregator.

https://api.mtpelerin.com/currency_rates/convert (POST)

Parameter
Example value
Description

sourceCurrency

CHF

One of our supported fiat or crypto Chains and currencies.

destCurrency

BTC

One of our supported fiat or crypto Chains and currencies.

sourceAmount

100

Input amount. ⚠️ Do not use it at the same time as destAmount, or you will get a 400 error.

destAmount

100

Output amount. ⚠️ Do not use at the same time as sourceAmount, or you will get a 400 error.

sourceNetwork

fiat

One of our supported chains (see Tokens endpoint above), or 'fiat'.

destNetwork

bitcoin_mainnet

One of our supported chains (see Tokens endpoint above), or 'fiat'.

isCardPayment

false

'true' or 'false' if the payment will be made by card (only valid if sourceNetwork is fiat, ignored otherwise)

Response example:

{
  "fees": {
    "networkFee": "2.2605",
    "fixFee": 0
  },
  "sourceCurrency": "CHF",
  "destCurrency": "BTC",
  "sourceNetwork": "fiat",
  "destNetwork": "bitcoin_mainnet",
  "sourceAmount": 100,
  "destAmount": "0.00398660113390708486776"
}

"destAmount" is the net final amount, which includes all applicable fees.

The endpoint returns an error in case of an off-ramp if the amount is inferior the minimum amount of CHF 50 (or equivalent in other fiat currencies).

To know via API the minimum off-ramp amount, you can use:

https://api.mtpelerin.com/currency_rates/sellLimits/:currency (GET)

Replace :currency by one of our supported currencies.

Example: https://api.mtpelerin.com/currency_rates/sellLimits/USD

Response example:

{
  "destCurrency": "USD",
  "limit": "62.341265"
}

Last updated