بِسْمِ ٱللَّهِ ٱلرَّحْمَـٰنِ ٱلرَّحِيمِ

API Documentation

Endpoints, schema, examples, and historical archive

No authentication. No rate limits. No registration required. Every response is a single JSON file served directly from GitHub Pages.

nisab.tahababa.com/nisab.json

01Endpoints

Today (live) 
curl https://nisab.tahababa.com/nisab.json
Specific snapshot 
curl https://nisab.tahababa.com/history/2026-03-15T0800GMT.json
History index 
curl https://nisab.tahababa.com/history/index.json

For lightweight integrations that only need a single currency, use the per-currency endpoint instead of downloading the full 37-currency file. Replace {CURRENCY} with any supported code (e.g. SAR, GBP, PKR).

Per-currency (SAR example) 
curl https://nisab.tahababa.com/nisab/SAR.json
json — response shape
{
  "meta": {
    "updated_at":    "2026-05-28T13:34:25.981Z",
    "currency":     "SAR",
    "pegged_to_usd": true
  },
  "nisab": {
    "hanafi":  { "label": "Hanafi",   "gold": 45297.99, "silver": 5428.69 },
    "maliki":  { "label": "Maliki",   "gold": 45297.99, "silver": 5274.79 },
    "shafii":  { "label": "Shafi'i",  "gold": 45297.99, "silver": 5274.79 },
    "hanbali": { "label": "Hanbali",  "gold": 45297.99, "silver": 5274.79 }
  }
}

Six currencies are pegged to the US Dollar — SAR, AED, QAR, OMR, BHD, JOD — and return "pegged_to_usd": true. Their Nisab values move only with gold and silver prices, not with exchange-rate fluctuation. See Why Does My Nisab Vary by Currency? for the full explanation.

An unsupported currency code (e.g. /nisab/XYZ.json) returns a 404 — these are served as static files by GitHub Pages.

02Code Examples

const { nisab, prices } = await fetch('https://nisab.tahababa.com/nisab.json')
  .then(r => r.json());

// Hanafi gold nisab in GBP
nisab.hanafi.gold.values.GBP    // → 10640.71

// Maliki silver nisab in EUR
nisab.maliki.silver.values.EUR  // → 547.32

// Live gold price per gram in USD
prices.gold.per_gram            // → 161.37

03Response Schema

json
{
  "meta": {
    "timestamp":      "2026-03-15T0800GMT",
    "updated_at":     "2026-03-15T09:01:22.000Z",
    "timezone":       "GMT",
    "base_currency":  "USD",
    "currencies":     ["USD", "GBP", "EUR", /* 37 total */],
    "currency_count": 37,
    "fx_rate_date":   "2026-03-15",
    "usd_pegged": {
      "currencies": ["SAR", "AED", "QAR", "OMR", "BHD", "JOD"],
      "note": "These currencies are fixed against the US Dollar…"
    },
    "hijri": {
      "day":          "15",
      "month_en":     "Ramadan",
      "month_ar":     "رَمَضَان",
      "year":         "1447",
      "formatted_en": "15 Ramadan 1447 AH"
    }
  },
  "prices": {
    "gold":   { "per_troy_oz": 5019.18, "per_gram": 161.37 },
    "silver": { "per_troy_oz":   80.61,  "per_gram":  2.59  }
  },
  "nisab": {
    "hanafi": {
      "gold":   { "grams": 85, "values": { "USD": 13706.56, "GBP": 10329.59, … } },
      "silver": { "grams": 612.36, "tola": 52.5, "values": { "USD": 1587.21, … } }
    },
    "maliki":  { /* same structure */ },
    "shafii":  { /* same structure */ },
    "hanbali": { /* same structure */ }
  }
}

04Historical Archive

Every snapshot is permanently committed to GitHub. 6 snapshots per day, every day — a growing, queryable price history of Nisab thresholds.

Recent snapshots:

Loading…

05Supported Currencies

Every Nisab value is returned in all 37 currencies simultaneously, including all GCC currencies, major Muslim-majority economies, and MENA & Central Asian currencies.

GCC currencies (SAR, AED, QAR, OMR, BHD) and JOD are flagged as USD-pegged in the API response. Their Nisab values move only with gold and silver prices — not with FX fluctuation.

06Frequently Asked Questions