{"uid":"cap_mgfzx7ekfbLA-6b_BamXi","slug":"zakat-calculation-4f781fcc","name":"Zakat Calculation","description":"Compute zakat due on wealth: cash, gold, silver, business inventory, receivables, crypto and stocks, less deductible liabilities. Returns the nisab threshold under BOTH the gold (85g) and silver (595g) standards and flags when they disagree, since the choice changes who owes. Supports lunar (2.5%) and solar (2.577%) years. Deterministic — you supply metal prices, so you control the source. Educational calculation, not a fatwa.","url":"https://api.qist.info/api/zakat?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"cash":{"type":"string","description":"Cash in hand and in bank accounts"},"crypto":{"type":"string","description":"Digital assets at market value"},"stocks":{"type":"string","description":"Shares held for trading, at market value"},"currency":{"type":"string","description":"Currency label for the output, e.g. AED, SAR, USD"},"yearType":{"type":"string","description":"lunar (default, 2.5%) or solar (2.577%)"},"goldGrams":{"type":"string","description":"Weight of zakatable gold in grams"},"nisabBasis":{"type":"string","description":"gold, silver, or both (default) — silver is lower so it obliges more payers"},"liabilities":{"type":"string","description":"Immediately-due debts, deducted from zakatable wealth"},"receivables":{"type":"string","description":"Good debt owed to you and expected to be repaid"},"silverGrams":{"type":"string","description":"Weight of zakatable silver in grams"},"goldPricePerGram":{"type":"string","description":"Current gold price per gram in your currency — needed for the gold nisab"},"businessInventory":{"type":"string","description":"Trade goods at market value"},"silverPricePerGram":{"type":"string","description":"Current silver price per gram — needed for the silver nisab (the lower, more common threshold)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z1bgKOPsq07lROJXng26p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes Islamic zakat obligation on multiple asset classes (cash, gold, silver, crypto, stocks, business inventory, receivables) against both gold and silver nisab thresholds, returning the zakat amount due and flagging threshold disagreements.","exampleAgentPrompt":"Calculate my zakat using both gold and silver nisab standards — I have $18,000 cash, $3,500 in crypto, $2,000 in stocks, $1,200 in business inventory, and $800 in liabilities; gold is currently $85 per gram and silver is $1.05 per gram, use USD and a lunar year.","exampleUseCases":[{"title":"Annual zakat on mixed household wealth","prompt":"Help me calculate my zakat for this year: I have 12,000 SAR in cash, 50 grams of gold, 200 grams of silver, and 5,000 SAR in receivables with 2,000 SAR in immediate debts. Gold is 220 SAR per gram and silver is 2.8 SAR per gram — show me both the gold and silver nisab thresholds and tell me if they disagree."},{"title":"Zakat on crypto and stock portfolio","prompt":"I want to know my zakat obligation on my investment portfolio: I hold $8,500 in Bitcoin, $4,200 in trading stocks, and $500 cash. No liabilities. Gold price is $83 per gram and silver is $0.98 per gram — calculate in USD using the lunar year and check both nisab standards."},{"title":"Small business owner zakat with inventory","prompt":"I run a small shop and need to figure out my zakat this year — I have $6,000 in business inventory, $3,000 cash, and $1,500 in good receivables I expect back, but I owe $2,000 in immediate debts. Please use both gold and silver nisab, gold is $82/gram and silver is $1.02/gram, currency is USD."}],"resultDescription":"Returns the total zakatable wealth after deducting liabilities, the calculated zakat amount due (at 2.5% lunar or 2.577% solar rate), the nisab threshold value under the gold standard (85g of gold) and the silver standard (595g of silver), and a flag indicating whether the two standards disagree on whether zakat is owed — helping the user understand which standard would change their obligation.","failureModes":["Missing required metal prices when nisabBasis includes gold or silver — calculation cannot proceed without goldPricePerGram or silverPricePerGram","Invalid yearType value — must be 'lunar' or 'solar'","Invalid nisabBasis value — must be 'gold', 'silver', or 'both'","Negative or non-numeric values for asset fields causing unexpected results","All asset fields omitted — returns zero zakat with no meaningful output"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, reproducible zakat calculation where you supply the metal prices yourself — ideal for financial apps, Islamic fintech, personal finance agents, and educational tools that need to show their workings. It uniquely supports both gold and silver nisab standards simultaneously and flags disagreements, which is critical for users following different scholarly opinions. Prefer this over generic finance calculators when the Islamic jurisprudential context (nisab, hawl, lunar/solar rate distinction) matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:39:14.231Z","isFirstParty":false,"canonicalSlug":"zakat-calculation-4f781fcc"}