zaref

South African reference data for AI agents: 33 verified series, 29 calculators, history, task-shaped answers (payroll, income tax, VAT, wage checks, working days), batch fetch and change-alert webhooks, paid per call via the x402 protocol (USDC on Base). No accounts, no API keys. Python client: pip install zaref.

Skills

• Fuel prices
  Current SA retail/wholesale fuel prices: petrol 93/95 (inland & coastal), diesel 50ppm, illuminating paraffin. Rand per litre.
• Repo & prime rate
  SARB repo rate and prime lending rate, South Africa's benchmark interest rates, with last MPC change date.
• CPI (headline, YoY)
  Latest Stats SA headline consumer inflation, year-on-year %, with reference month.
• Income tax tables
  SARS personal income tax brackets, rebates and thresholds for the current SA tax year, the tables PAYE is calculated from.
• VAT rate
  VAT rate currently in force in South Africa.
• UIF & OID limits
  UIF contribution remuneration ceiling and OID (COIDA) earnings threshold.
• National minimum wage
  National minimum wage per hour, incl. special categories, with effective date.
• Public holidays
  Official SA public holidays for the current calendar year, incl. proclaimed one-offs and Sunday observances.
• School terms
  DBE public school term dates.
• SASSA grant amounts
  All SASSA social grant amounts incl. SRD, with effective date.
• SARS travel rates
  SARS prescribed per-km reimbursement rate and subsistence allowances for the current tax year.
• Other national tax rates
  Corporate tax, dividends WHT, CGT inclusion, transfer duty brackets, retirement caps, medical tax credits, interest exemptions, estate/donations tax.
• Unemployment rate
  Latest Stats SA QLFS official and expanded unemployment rates, with reference quarter.
• GDP growth
  Latest Stats SA GDP growth (QoQ and YoY), with reference quarter.
• PPI (final manufactured goods)
  Latest Stats SA producer inflation YoY, with reference month.
• Toll fees
  Mainline toll plaza tariffs (vehicle classes 1-4) for the major national routes, current adjustment.
• Electricity tariffs
  NERSA-approved Eskom tariff increases and key residential rates for the current year.
• Metro municipal tariffs
  Residential electricity/water/refuse/rates headline tariffs for the 5 big metros, current municipal year.
• Learnership allowances
  Minimum weekly learnership allowances per NQF level, per the current NMW gazette.
• Sectoral minimum wages
  Minimum wages for sectors with their own determinations (contract cleaning, private security, etc.) beside the NMW.
• SARS & prescribed interest rates
  Official rate of interest (fringe benefits, s7C loans), SARS interest on outstanding taxes and refunds, and the prescribed rate of interest for legal and judgment debts.
• Retirement & TFSA limits
  Retirement contribution deduction cap, tax-free savings limits, retirement and withdrawal lump-sum tax tables, living-annuity thresholds.
• NCA maximum interest rates
  Maximum lawful interest rates per credit type under National Credit Act (NCA) Regulation 42 Table A, computed at the current repo rate, plus the in duplum rule and service fee cap.
• BCEA earnings threshold
  The BCEA earnings threshold, which working-time protections fall away above it, the earnings definition and related LRA/EEA effects.
• Tax calendar
  SARS filing-season windows, provisional tax deadlines, employer reconciliation windows and recurring monthly deadlines.
• Exchange control allowances
  Single discretionary allowance (R2m from April 2026), foreign investment allowance, minors' travel and cash export limits, with the TCS PIN rules.
• Deeds Office fees
  Deeds Office transfer and bond registration fee tiers, lodgement and ancillary fees, per the current gazetted schedule.
• Fuel levies
  General fuel levy, RAF levy and carbon fuel levy per litre for petrol and diesel, plus the carbon tax rate, including temporary relief episodes.
• ZARONIA benchmark rate
  SARB's ZARONIA risk-free overnight benchmark, the designated JIBAR successor (JIBAR ceases 2026-12-31), with the transition timeline and daily-rate history for compounded interest calculations.
• SARS wear-and-tear write-off periods
  SARS BGR7 schedule of straight-line depreciation write-off periods (in years) for over 140 asset classes, plus the R7,000 small-item write-off threshold.
• ZAR exchange rates
  SARB indicative daily ZAR exchange rates against USD, GBP, EUR and JPY, plus the nominal effective exchange rate (trade-weighted) index.
• SA benchmark bond yields
  SARB closing yields on the R2030 and R209 South African government benchmark bonds, key reference points for the domestic yield curve.
• SA sovereign credit rating
  South Africa's current credit rating and outlook from Moody's, S&P Global and Fitch, with each agency's most recent rating action date.
• Government tenders (live)
  Live South African government tender feed from National Treasury's eTenders OCDS API: filter by province, procurement category, buyer, keyword and closing window. Returns compact tender records with closing dates, briefing sessions, documents and contacts.
• Crypto ZAR prices (live)
  Live ZAR crypto prices from VALR's public market data: last traded, bid/ask, 24-hour high/low/volume and daily change for BTC, ETH and every other ZAR pair on the exchange.
• Calculator: income-tax
  SA personal income tax (PAYE) for the current tax year: annual and monthly tax, effective and marginal rate, SARS age rebates applied.
• Calculator: net-salary
  Net take-home from a gross monthly salary: PAYE plus employee UIF at the current tables.
• Calculator: transfer-duty
  Property transfer duty from the current SARS brackets.
• Calculator: fuel-cost
  Fuel cost for a trip at current official SA fuel prices.
• Calculator: toll-route
  Total mainline toll cost for a full run of a national route at current gazetted tariffs.
• Calculator: vat
  Add or strip VAT at the current SA rate (direction=add | remove | strip; unrecognised values are rejected). Free.
• Calculator: cgt
  Capital gains tax for individuals (marginal method), companies and trusts.
• Calculator: estate-duty
  Estate duty after the section 4A abatement, tiered at R30m.
• Calculator: learnership
  Minimum weekly learnership allowance by NQF level and credits.
• Calculator: lump-sum-tax
  Tax on a retirement fund lump sum or withdrawal using the cumulative SARS method (prior lump sums aggregate).
• Calculator: nca-max-rate
  Maximum lawful interest rate for a credit agreement under NCA Regulation 42 Table A, at the current or a given repo rate.
• Calculator: property-costs
  Total statutory costs of buying a property: transfer duty plus Deeds Office transfer, bond and lodgement fees.
• Calculator: two-pot-withdrawal
  Tax on a two-pot retirement savings-component withdrawal at the member's marginal rate.
• Calculator: travel-allowance
  PAYE inclusion and monthly tax impact of a fixed travel allowance under the 80/20 rule.
• Calculator: company-car
  Company car fringe benefit: monthly taxable value (3.5%/3.25%) and PAYE impact.
• Calculator: bond-repayment
  Monthly bond repayment and total interest, at the live prime rate by default.
• Calculator: zaronia-interest
  Compound-in-arrears interest on a principal over a date range, using zaref's accumulating daily ZARONIA history (ACT/365). Coverage limited to dates zaref has tracked.
• Calculator: uif
  Monthly UIF contribution (employee 1% + employer 1%) at the current earnings ceiling.
• Calculator: donations-tax
  Donations tax owed on a donation, after the annual natural-person exemption.
• Calculator: local-interest
  Taxable local interest after the age-based annual exemption.
• Calculator: medical-tax-credit
  Medical scheme (medical aid) fees tax credit plus the additional medical expenses tax credit from qualifying out-of-pocket costs.
• Calculator: provisional-tax
  Estimated first and second provisional tax payments (50/50 split) net of employees' tax already withheld, with the current filing deadlines.
• Calculator: net-to-gross
  Gross monthly salary required to net a target take-home amount, at the current tax tables.
• Calculator: home-office-expense
  Deductible home office expense by area apportionment (s23(b)/(m)).
• Calculator: sbc-tax
  Small Business Corporation income tax at the progressive SBC rates (eligibility conditions apply).
• Calculator: wear-and-tear
  Annual and monthly straight-line wear-and-tear allowance for an asset, using the SARS BGR7 write-off period schedule.
• Calculator: crypto-tax
  Estimated SA tax on crypto asset gains: revenue-nature profits taxed at the marginal rate, capital-nature gains via CGT with the annual exclusion and 40% inclusion. Handles staking/mining/airdrop receipts and FIFO batch matching of a raw buy/sell transaction list.
• Calculator: crypto-classify
  Indicative capital-vs-revenue classification of crypto gains by weighing the classic SA case-law factors: intention, holding period and trading frequency.
• Calculator: bond-price
  Clean price of a fixed-rate bond from face value, coupon and years to maturity, at a given yield (defaults to the live R2030 benchmark yield).
• Answer: income-tax
  Full income-tax answer for one taxpayer: tax due after age rebates and medical scheme credits, effective rate, monthly PAYE equivalent, with the component calculations included.
• Answer: payroll
  One employee's monthly payroll: PAYE with age rebates, pension deductibility (27.5% / R430k cap), medical scheme credit, employee and employer UIF, take-home pay, employer cost, BCEA earnings-threshold flag and an optional minimum-wage check.
• Answer: vat
  VAT answer at the rate currently in force: add or remove VAT on an amount, with the rate's status, effective date and official citation.
• Answer: wage-check
  National minimum wage compliance verdict for a wage: compliant or not, the applicable floor (standard, farm, domestic or EPWP) and the shortfall per hour, with the gazette citation.
• Answer: working-days
  Working days between two dates (inclusive), excluding weekends and SA public holidays from the verified holiday series, listing the holidays in range.
• Change-alert webhooks
  Register an HTTPS webhook that fires when a subscribed series' verified values change. One payment buys a 90-day subscription; notifications carry the changed series and its new effective date (signed with a per-subscription HMAC secret), never the values themselves. Undeliverable endpoints are disabled after 10 consecutive failures.
• Batch series fetch
  Fetch up to 10 series in one settled call. Cheaper than four individual calls and a single round trip instead of several. Each entry carries its own source_url, effective_date and freshness flag, exactly as the individual endpoints do. Supports as_at for a point-in-time batch.

How to call

https://zaref.dev

Listed in

Directories this entry was found in.