डेवलपर API

एक मिनट में शुरू करें

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

{
  "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" }
  ]
}

बुनियादी बातें

बेस URL

https://api.geneh.app/v1

प्रमाणीकरण

अपनी कुंजी Authorization हेडर में Bearer के बाद भेजें। टेस्ट कुंजियाँ gk_test से शुरू होती हैं और तय डेटा लौटाती हैं।

फ़ॉर्मैट

UTF-8 में JSON। समय UTC में, राशियाँ दशमलव में, नाम अरबी और अंग्रेज़ी में।

सीमाएँ

हर जवाब में X-RateLimit-Remaining होता है। सीमा पार करने पर आपको Retry-After के साथ 429 मिलता है।

संस्करण

संस्करण URL में होता है। हम v1 को कभी नहीं तोड़ते, और नए संस्करण की घोषणा 12 महीने पहले करते हैं।

लाइब्रेरी

JavaScript, Python, PHP, Swift, Kotlin, Flutter, Go, .NET