Skip to content
/fx

fx

Foreign-exchange rates. FX transfers are private label.

Operations

Get current FX conversion rate

Request

Returns the current exchange rate between two currencies, including buy/sell markup.

Security
oauth2ClientCredentials(Required scopes: fx:write)
Headers
business_idstringrequired

Business identifier for the request

Bodyapplication/jsonrequired
fromstringrequired

Source currency code (ISO 4217)

Example:"USD"
tostringrequired

Target currency code (ISO 4217)

Example:"KES"
curl -i -X POST \
  https://developer.boyahq.com/_mock/v2/openapi/fx/conversion-rate \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'business_id: string' \
  -d '{
    "from": "USD",
    "to": "KES"
  }'

Responses

Conversion rate returned successfully

Bodyapplication/json
fromstringrequired
Example:"USD"
tostringrequired
Example:"KES"
ratenumberrequired
Example:129.122
timestampstringrequired
Example:"2026-04-23T00:00:00Z"
markupobject(FxMarkupDto)required
Response
{
  "from": "USD",
  "to": "KES",
  "rate": 129.122,
  "timestamp": "2026-04-23T00:00:00Z",
  "markup": {
    "buy": 2,
    "sell": 2
  }
}