Skip to main content
POST
Get a quote

Authorizations

X-RAMPNOW-API-KEY
string
header
required

Partner API key sent in the X-RAMPNOW-API-KEY header. Every request must ALSO send X-RAMPNOW-TIMESTAMP (unix seconds) and X-RAMPNOW-SIGN (hex HMAC-SHA256 of timestamp + METHOD + requestURI + rawBody, keyed with your API secret). See the Authentication guide.

Body

application/json

GetRampOrderQuoteRequest asks for a non-binding price quote for a ramp order. Supply exactly one of srcAmount / dstAmount — the other side is computed.

dstChain
string
required

Destination chain (fiat for fiat legs)

Supported Blockchains like ethereum, bitcoin etc. For additional options, see the full list.

dstCurrency
string
required

Destination currency

Supported Crypto Currencies like EUR, USDT etc. For additional options, see the full list.

orderType
enum<string>
required

Order direction (buy, sell, …)

Available options:
unknown,
buy,
sell,
swap,
payment,
refill,
payout,
cross_border,
payroll,
sendout,
escrow
srcChain
string
required

Source chain (fiat for fiat legs)

Supported Blockchains like ethereum, bitcoin etc. For additional options, see the full list.

srcCurrency
string
required

Source currency

Supported Crypto Currencies like EUR, USDT etc. For additional options, see the full list.

dstAmount
string

Destination-side amount; set this OR srcAmount, not both

partnerFixedFee
number

Overrides the account-side partner fixed fee for this quote

partnerPctFee
number

Overrides the account-side partner fee percentage for this quote

paymentMode
string

Preferred payment method — quote may differ across modes

Payment Methods & Limits like sepa, card, wire etc. For additional options, see the full list.

srcAmount
string

Source-side amount; set this OR dstAmount, not both

Response

200 - application/json

OK

code
integer
required
data
object
required

GetOrderRampQuoteResponse is the priced quote for the requested route. Non-binding — the actual order may re-quote at creation time.

message
string
required
traceId
string
required
displayError
string

For client display