Skip to main content
GET
/
api
/
partner
/
v2
/
cross-ramp
/
quotes
cURL
curl --request GET \
  --url https://staging-api.capa.fi/api/partner/v2/cross-ramp/quotes \
  --header 'partner-api-key: <partner-api-key>'
{
  "success": true,
  "data": {
    "fees": {
      "fixedFee": 25,
      "feeCurrency": "MXN"
    },
    "sourceAmount": 5000,
    "sourceCurrency": "DOP, MXN, USD",
    "targetAmount": 40,
    "targetCurrency": "DOP, MXN, USD",
    "rate": 57.01,
    "spread": 0.005,
    "flow": "REGULAR | OTC",
    "premiumSpread": 0.01
  }
}
Retrieves a real-time exchange rate for a fiat-to-fiat (cross-ramp) conversion. Use this to display estimated amounts before creating a transaction.

​
Field Relationships

  • Provide either sourceAmount or targetAmount, not both.

​
Important Notes

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input”
400BAD_REQUEST”Requested fiat currency is invalid or inactive”

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Query Parameters

​
sourceCurrency
enum<string>
required

The source fiat currency symbol

Available options:
MXN,
DOP,
USD,
EUR
Example:

"MXN"

​
targetCurrency
enum<string>
required

The target fiat currency symbol

Available options:
MXN,
DOP,
USD,
EUR
Example:

"USD"

​
sourceAmount
number

The amount of source fiat currency to convert

​
targetAmount
number

The desired amount of target fiat currency to receive

​
premiumSpread
number

Spread percentage to be applied to the exchange rate

Response

200 - application/json

Successful response

​
success
boolean
Example:

true

​
data
object