Ramp Quotes

Ramp quotes provide real-time exchange rates for converting between local African currencies and USD stablecoins. Each quote is valid for a limited time and must be used or refreshed before expiration.

Getting a Quote

Arguments

Argument
Type
Description

customer

ID!

Global ID of the paying customer (Create a Customer)

amount

Decimal!

Amount to convert

currency

P2PPaymentCurrency!

local_currency or usd

paymentType

PaymentType

deposit or withdrawal

paymentMethodType

String!

Payment rail identifier (e.g., bank_transfer_ng)

query {
  rampQuote(
    amount: 100
    currency: usd
    customer: "VHlwZXM6OkNhc2hyYW1wOjpBUEk6Ok1lcmNoYW50Q3VzdG9tZXItMzgwYzEwZTctNzgwNC00MmU3LWI2NTItYWNiMGQ5OTA4NDYy"
    paymentType: deposit
    paymentMethodType: "bank_transfer_ng"
  ) {
    id
    exchangeRate
    paymentType
  }
}

Response

Field
Description

id

Ramp quote global ID for use in subsequent calls

exchangeRate

Current rate for the currency pair

paymentType

deposit or withdrawal

Quote Lifecycle

  1. Creation: Quote is generated with current market rate

  2. Valid Period: 30-180 seconds depending on market volatility

  3. Expiration: Quote becomes invalid and must be refreshed

  4. Usage: Quote is consumed by initiating a deposit or withdrawal

Refreshing Quotes

When a quote expires or is close to expiring, refresh it to get updated rates.

Arguments

Argument
Type
Description

rampQuote

ID!

ID of the quote to refresh

amount

Decimal

Optional new amount (keeps original if omitted)

mutation {
  refreshRampQuote(
    rampQuote: "VHlwZXM6OkNhc2hyYW1wOjpBUEk6OlJhbXBRdW90ZS04ZGFkZjEzYS1mYzNjLTQzN2EtYmZkZC04NDAyN2Y2MmIxZjY="
    amount: 100
  ) {
    id
    exchangeRate
    paymentType
  }
}

Last updated