Fuel prices, interest rates, FX rates, bond yields, tax tables, tolls, tariffs, wages and grants, with live government tenders and crypto prices, plus 29 calculators on top. The values that live in government PDFs, served as clean JSON with the official source attached to every response.
Free series, answers instantly, no payment needed. Paid series reply 402 with payment instructions in the headers.
Python? pip install zaref · free endpoints need no wallet · Python guide →
Every series follows one discipline: each value carries source_url, effective_date, last_confirmed and next_expected_update. A series past its expected update declares stale: true instead of pretending. Values we cannot verify are null with a note, never a guess.
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.
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.
Current SA retail/wholesale fuel prices: petrol 93/95 (inland & coastal), diesel 50ppm, illuminating paraffin. Rand per litre.
SARB repo rate and prime lending rate, South Africa's benchmark interest rates, with last MPC change date.
Latest Stats SA headline consumer inflation, year-on-year %, with reference month.
SARS personal income tax brackets, rebates and thresholds for the current SA tax year, the tables PAYE is calculated from.
VAT rate currently in force in South Africa.
UIF contribution remuneration ceiling and OID (COIDA) earnings threshold.
National minimum wage per hour, incl. special categories, with effective date.
Official SA public holidays for the current calendar year, incl. proclaimed one-offs and Sunday observances.
DBE public school term dates.
All SASSA social grant amounts incl. SRD, with effective date.
SARS prescribed per-km reimbursement rate and subsistence allowances for the current tax year.
Corporate tax, dividends WHT, CGT inclusion, transfer duty brackets, retirement caps, medical tax credits, interest exemptions, estate/donations tax.
Latest Stats SA QLFS official and expanded unemployment rates, with reference quarter.
Latest Stats SA GDP growth (QoQ and YoY), with reference quarter.
Latest Stats SA producer inflation YoY, with reference month.
Mainline toll plaza tariffs (vehicle classes 1-4) for the major national routes, current adjustment.
NERSA-approved Eskom tariff increases and key residential rates for the current year.
Residential electricity/water/refuse/rates headline tariffs for the 5 big metros, current municipal year.
Minimum weekly learnership allowances per NQF level, per the current NMW gazette.
Minimum wages for sectors with their own determinations (contract cleaning, private security, etc.) beside the NMW.
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 contribution deduction cap, tax-free savings limits, retirement and withdrawal lump-sum tax tables, living-annuity thresholds.
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.
The BCEA earnings threshold, which working-time protections fall away above it, the earnings definition and related LRA/EEA effects.
SARS filing-season windows, provisional tax deadlines, employer reconciliation windows and recurring monthly deadlines.
Single discretionary allowance (R2m from April 2026), foreign investment allowance, minors' travel and cash export limits, with the TCS PIN rules.
Deeds Office transfer and bond registration fee tiers, lodgement and ancillary fees, per the current gazetted schedule.
General fuel levy, RAF levy and carbon fuel levy per litre for petrol and diesel, plus the carbon tax rate, including temporary relief episodes.
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 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.
SARB indicative daily ZAR exchange rates against USD, GBP, EUR and JPY, plus the nominal effective exchange rate (trade-weighted) index.
SARB closing yields on the R2030 and R209 South African government benchmark bonds, key reference points for the domestic yield curve.
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.
Computed answers from the same verified tables, so a sweep that updates a table updates every answer with zero code changes. Each response carries the same source_url and effective_date discipline as the series it reads from.
SA personal income tax (PAYE) for the current tax year: annual and monthly tax, effective and marginal rate, SARS age rebates applied.
Net take-home from a gross monthly salary: PAYE plus employee UIF at the current tables.
Property transfer duty from the current SARS brackets.
Fuel cost for a trip at current official SA fuel prices.
Total mainline toll cost for a full run of a national route at current gazetted tariffs.
Add or strip VAT at the current SA rate (direction=add | remove | strip; unrecognised values are rejected). Free.
Capital gains tax for individuals (marginal method), companies and trusts.
Estate duty after the section 4A abatement, tiered at R30m.
Minimum weekly learnership allowance by NQF level and credits.
Tax on a retirement fund lump sum or withdrawal using the cumulative SARS method (prior lump sums aggregate).
Maximum lawful interest rate for a credit agreement under NCA Regulation 42 Table A, at the current or a given repo rate.
Total statutory costs of buying a property: transfer duty plus Deeds Office transfer, bond and lodgement fees.
Tax on a two-pot retirement savings-component withdrawal at the member's marginal rate.
PAYE inclusion and monthly tax impact of a fixed travel allowance under the 80/20 rule.
Company car fringe benefit: monthly taxable value (3.5%/3.25%) and PAYE impact.
Monthly bond repayment and total interest, at the live prime rate by default.
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.
Monthly UIF contribution (employee 1% + employer 1%) at the current earnings ceiling.
Donations tax owed on a donation, after the annual natural-person exemption.
Taxable local interest after the age-based annual exemption.
Medical scheme (medical aid) fees tax credit plus the additional medical expenses tax credit from qualifying out-of-pocket costs.
Estimated first and second provisional tax payments (50/50 split) net of employees' tax already withheld, with the current filing deadlines.
Gross monthly salary required to net a target take-home amount, at the current tax tables.
Deductible home office expense by area apportionment (s23(b)/(m)).
Small Business Corporation income tax at the progressive SBC rates (eligibility conditions apply).
Annual and monthly straight-line wear-and-tear allowance for an asset, using the SARS BGR7 write-off period schedule.
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.
Indicative capital-vs-revenue classification of crypto gains by weighing the classic SA case-law factors: intention, holding period and trading frequency.
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).
Plain-English guides to each dataset: what it covers, its official source, and how to call it. Written for developers wiring South African data into an app or an agent.
Current SARB repo rate and prime lending rate as a JSON API with official citations, effective dates and history. Pay per call in USDC, no API key.
South African government bond yields as a JSON API: SARB closing yields on the R2030 and R209 benchmarks, refreshed every business day, with citations and history. Pay per call in USDC, no API key.
Official South African petrol and diesel prices as a JSON API: inland and coastal, monthly DMPR adjustments, fuel levies, with citations and history.
SARS income tax brackets, rebates and thresholds as a JSON API, plus PAYE, net salary and provisional tax calculators. Cited to the official tax tables.
The current South African VAT rate as JSON, with a free add or remove VAT calculator. Cited to SARS, no API key, no signup.
South African public holidays as a free JSON API, including Monday observances under the Public Holidays Act, plus school terms. No key, no signup.
Daily ZARONIA benchmark rate as a JSON API with accumulating history and a compound interest calculator. SARB-verified, built for the JIBAR transition.
Official SARB daily rand exchange rates as a JSON API: USD, GBP, EUR, JPY and the effective exchange rate index, with citations and history.
Run South African payroll from an API: PAYE from the current SARS tables, age rebates, pension deductibility, medical scheme credits, employee and employer UIF, and net take-home pay. Cited, paid per call.
The South African national minimum wage as a JSON API, with farm, domestic and EPWP floors, sectoral determinations, learnership allowances and a compliance verdict endpoint. Cited to the gazette.
Maximum lawful interest rates under National Credit Act Regulation 42 as a JSON API: per credit type, computed from the repo rate, with the in duplum rule and the service fee cap. Cited to the gazette.
The zaref Python client: pip install zaref, then read South African reference data with no API key. Free endpoints need no wallet; paid endpoints settle in USDC via x402.
A working x402 integration example: discover endpoints, receive the 402 challenge, pay USDC on Base and get JSON. No account, no API key, half a cent per call.
No accounts, no API keys. Machine-readable discovery via llms.txt, OpenAPI 3.1, and an MCP server at /mcp. Ask for JSON, get JSON; this page only exists for humans.
$0.005 USDC per series call, $0.02 to $0.10 for task-shaped answers (payroll, wage checks, working days), $0.025 for the full bundle, $0.10 for a 90-day change-alert webhook, paid per request via the x402 protocol on Base. No signup, no invoices: the 402 response carries the payment requirements and capable clients pay and retry automatically. The catalog and public holidays are free. A call costs less than the tokens an agent burns finding and parsing the official source itself.
Monthly fuel and inflation cycles, MPC decisions, annual gazettes and municipal years are tracked per series. The update cadence is printed on every card above.
Dated history per series at /v1/{series}/history, point-in-time answers with ?as_at=YYYY-MM-DD on series and calculators, and a cheap cache-freshness diff at /v1/changes?since= for agents that only want to know what moved.