Skip to main content
POST
/
api
/
partner
/
v2
/
cross-ramp
/
quotes
cURL
curl --request POST \
  --url https://staging-api.capa.fi/api/partner/v2/cross-ramp/quotes \
  --header 'Content-Type: application/json' \
  --header 'partner-api-key: <partner-api-key>' \
  --data '
{
  "sourceCurrency": "MXN",
  "targetCurrency": "USD",
  "sourceAmount": 123,
  "targetAmount": 123,
  "premiumSpread": 123
}
'
{
  "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",
    "quoteId": "123e4567-e89b-12d3-a456-426614174000",
    "expiresAt": "2025-01-01T00:00:00.000Z",
    "premiumSpread": 0.01
  }
}
Creates a locked cross-ramp quote with a guaranteed exchange rate. Pass the returned quoteId when creating a cross-ramp transaction.

​
Field Relationships

  • Provide either sourceAmount or targetAmount, not both.

​
Important Notes

  • Quotes expire — check the expiresAt field and create the transaction before it lapses.
  • Pass the returned quoteId to Create Cross-Ramp.

​
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”
500INTERNAL_SERVER_ERROR”Failed to create quote”

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Body

application/json
​
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

201 - application/json
​
success
boolean
Example:

true

​
data
object