Developer API

Overview Reference Webhooks SDKs Keys and usage Plans

Egypt's rates in your app

One API for currency rates at every bank, gold and silver, transfers, certificates, treasury bills and funds, with webhooks that tell you about every change.

Get a free key Reference

Currency rates18 currencies at every bank

Gold and silverKarats, bars and pounds

TransfersWhat arrives with each provider

CertificatesEvery bank certificate

Treasury billsBefore and after tax

Funds216 funds

HistoryDaily and hourly

WebhooksWe push changes to you

Start in a minute

Request

curl https://api.geneh.app/v1/rates/usd \
  -H "Authorization: Bearer gk_live_YOUR_KEY"

Response

{
  "currency": "USD",
  "updated_at": "2026-10-16T00:37:00Z",
  "cbe": { "buy": 53.39, "sell": 53.53 },
  "best": {
    "sell": { "bank": "credit_agricole", "rate": 53.47 },
    "buy":  { "bank": "adib", "rate": 53.55 }
  },
  "banks": [
    { "bank": "nbe", "buy": 53.42, "sell": 53.52, "updated_at": "2026-10-16T00:31:00Z" }
  ]
}

Basics

Base URL: https://api.geneh.app/v1
Authentication: Send your key in the Authorization header after Bearer. Keys on geneh.app start with gk_live.
Format: JSON in UTF-8. Times in UTC, amounts as decimals, names in Arabic and English.
Limits: Responses carry X-RateLimit-Remaining. Over the limit you get 429 with Retry-After.
Versions: The version is in the URL. We never break v1, and we announce a new version 12 months ahead.
Libraries: JavaScript, Python, PHP, Swift, Kotlin, Flutter, Go, .NET

Put the dollar rate on your siteA ready widget in one line that updates itself and supports Arabic and dark mode. Free with a Geneh credit.

Coming soon

Egypt's rates in your app

Start in a minute

Basics

mark_email_unreadThe week's prices in your inbox

The week's prices in your inbox