← Home

API docs

Every request needs an API key in the Authorization header: Authorization: Bearer brk_live_.... Requests count against your plan's monthly quota; exceeding it returns 429.

GET/v1/rates/current

Latest observation per provider for a corridor, ranked by what the recipient gets.

curl "https://ratenify.com/v1/rates/current?from=GBP&to=NGN&amount=100" \
  -H "Authorization: Bearer brk_live_..."
POST/v1/rates/historical

Past observations for one provider and corridor, newest first, cursor-paginated via `before`.

curl -X POST "https://ratenify.com/v1/rates/historical" \
  -H "Authorization: Bearer brk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"productAlias": "pesa", "from": "GBP", "to": "NGN", "limit": 50}'
GET/v1/rates/currencies

Every currency this API supports.

curl "https://ratenify.com/v1/rates/currencies" \
  -H "Authorization: Bearer brk_live_..."
GET/v1/rates/products

Every provider we track, with its alias, name, and logo.

curl "https://ratenify.com/v1/rates/products" \
  -H "Authorization: Bearer brk_live_..."

How these rates are collected