Rates

WeWire's Rates API allows you to preview near real-time exchange rates between various currencies.

WeWire's Rates API allows you to preview near real-time exchange rates between our supported currencies. Whether you're building a payment platform, marketplace, or financial service, this API helps you fetch the latest market rates to display, calculate, or execute currency conversions confidently.

The API provides bid and ask prices for each currency pair:

• Bid Rate: This is the price at which WeWire is willing to buy the base currency. In other words, it's the rate you will receive if you are selling the base currency to WeWire.

• Ask Rate (also called Offer Rate): This is the price at which WeWire is willing to sell the base currency. It's the rate you will pay if you are buying the base currency from WeWire.

In every currency pair, there are two currencies involved:

• Base Currency: This is the first currency in the currency pair. It is the currency you want to convert from.

• Destination Currency (also called Quote Currency): This is the second currency in the currency pair. It is the currency you want to convert to.

The exchange rate tells you how much of the destination currency is equivalent to one unit of the base currency.

Example: For the currency pair USD/GHS:

• Base Currency = USD (US Dollar)

• Destination Currency = GHS (Ghanaian Cedi)

The difference between the bid and ask rates is known as the spread, which reflects market liquidity, demand, and transaction costs.

Get all exchange rates

get

https://stage-capi.wewireafrica.comhttps://capi.wewireafrica.com

/v1/rates

Retrieves all available currency exchange rates

Authorizations

ww-api-key

ww-api-keystringRequired

Responses

200

List of all exchange rates

application/json

get

/v1/rates

HTTPcURLJavaScriptPython

GET /v1/rates HTTP/1.1
Host: stage-capi.wewireafrica.com
ww-api-key: YOUR_API_KEY
Accept: */*

200

List of all exchange rates

[
  {
    "from": "USD",
    "to": "EUR",
    "bid": 1,
    "ask": 1
  }
]

Get exchange rate for currency pair

get

https://stage-capi.wewireafrica.comhttps://capi.wewireafrica.com

/v1/rates/pair

Retrieves the exchange rate between two specified currencies

Authorizations

ww-api-key

ww-api-keystringRequired

Query parameters

fromstring · enumRequired

Source currency code

Possible values:

tostring · enumRequired

Target currency code

Possible values:

Responses

200

Exchange rate for the currency pair

application/json

400

Invalid currency codes

get

/v1/rates/pair

HTTPcURLJavaScriptPython

GET /v1/rates/pair?from=NGN&to=NGN HTTP/1.1
Host: stage-capi.wewireafrica.com
ww-api-key: YOUR_API_KEY
Accept: */*

{
  "currency": "USD",
  "rate": 0.85,
  "targetCurrency": "EUR"
}

Preview currency conversion

post

https://stage-capi.wewireafrica.comhttps://capi.wewireafrica.com

/v1/rates/conversion/preview

Calculates the result of converting an amount between currencies including fees

Authorizations

ww-api-key

ww-api-keystringRequired

Body

application/json

objectOptional

Responses

200

Conversion preview with rates and fees

application/json

post

/v1/rates/conversion/preview

HTTPcURLJavaScriptPython

POST /v1/rates/conversion/preview HTTP/1.1
Host: stage-capi.wewireafrica.com
ww-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "from": "USD",
  "to": "EUR",
  "amount": 100
}

200

Conversion preview with rates and fees

{
  "convertedAmount": 85,
  "rate": 0.85,
  "fee": 2.5
}