zaref

Endpoints (104 live)

• GET /v1/repo-prime — South African Repo & prime rate (SARB repo rate and prime lending rate, South Africa's benchmark interest rates, with last MPC change date.) Clean cited JSON with official source URL, effective date and freshness flag. (0.005 USDC on Base)
• GET /v1/bond-yields — South African 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.) Clean cited JSON with official source URL, effective date and freshness flag. (0.005 USDC on Base)
• GET /v1/crypto-prices — South African 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. Live from VALR's public market data. (0.005 USDC on Base)
• GET /v1/fuel-prices — South African Fuel prices (Current SA retail/wholesale fuel prices: petrol 93/95 (inland & coastal), diesel 50ppm, illuminating paraffin. Rand per litre.) Clean cited JSON with official source URL, effective date and freshness flag. (0.005 USDC on Base)
• GET /v1/cpi — Returns CPI data from the /v1/cpi endpoint. (0.005 USDC on Base)
• GET /v1/changes — Which South African reference series changed or were reconfirmed since a given date. The cheap cache-freshness check for agents. Optional param: since=YYYY-MM-DD (defaults to the last 30 days). (0.005 USDC on Base)
• GET /calc/zaronia-interest — South African zaronia-interest calculator. 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. Computed from officially-sourced tables. Example: /calc/zaronia-interest?principal=1000000&start=2026-07-10&end=2026-07-14 (0.01 USDC on Base)
• POST /v1/alerts — South African reference-data change alerts. 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. POST a JSON body, e.g. {"url":"https://example.com/hooks/zaref","series":["fuel-prices","repo-prime"]}. (0.1 USDC on Base)
• POST /v1/answers/wage-check — South African wage-check answer for AI agents. 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. Composed from the same officially-sourced, daily-audited tables as the calculators. POST a JSON body, e.g. {"monthly_wage":6000,"hours_per_week":45,"worker_type":"domestic"}. (0.05 USDC on Base)
• POST /v1/answers/working-days — South African working-days answer for AI agents. Working days between two dates (inclusive), excluding weekends and SA public holidays from the verified holiday series, listing the holidays in range. Composed from the same officially-sourced, daily-audited tables as the calculators. POST a JSON body, e.g. {"from":"2026-08-01","to":"2026-08-31"}. (0.02 USDC on Base)
• GET /calc/two-pot-withdrawal — South African two-pot-withdrawal calculator. Tax on a two-pot retirement savings-component withdrawal at the member's marginal rate. Computed from officially-sourced tables. Example: /calc/two-pot-withdrawal?amount=50000&annual_income=600000 (0.01 USDC on Base)
• GET /calc/donations-tax — South African donations-tax calculator. Donations tax owed on a donation, after the annual natural-person exemption. Computed from officially-sourced tables. Example: /calc/donations-tax?amount=500000 (0.01 USDC on Base)
• GET /calc/local-interest — South African local-interest calculator. Taxable local interest after the age-based annual exemption. Computed from officially-sourced tables. Example: /calc/local-interest?amount=40000&age=40 (0.01 USDC on Base)
• GET /calc/net-salary — South African net-salary calculator. Net take-home from a gross monthly salary: PAYE plus employee UIF at the current tables. Computed from officially-sourced tables. Example: /calc/net-salary?monthly=50000&age=35 (0.01 USDC on Base)
• GET /calc/home-office-expense — South African home-office-expense calculator. Deductible home office expense by area apportionment (s23(b)/(m)). Computed from officially-sourced tables. Example: /calc/home-office-expense?office_area_m2=12&home_area_m2=180&annual_home_costs=240000 (0.01 USDC on Base)
• POST /v1/batch — South African reference data, several series in one settled call. 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. POST a JSON body, e.g. {"series":["repo-prime","fuel-prices","vat","cpi"]}. (0.02 USDC on Base)
• GET /calc/sbc-tax — South African sbc-tax calculator. Small Business Corporation income tax at the progressive SBC rates (eligibility conditions apply). Computed from officially-sourced tables. Example: /calc/sbc-tax?annual_taxable_income=600000 (0.01 USDC on Base)
• POST /v1/answers/payroll — South African payroll answer for AI agents. 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. Composed from the same officially-sourced, daily-audited tables as the calculators. POST a JSON body, e.g. {"monthly_gross":40000,"age":34,"pension_percent":7.5,"medical_members":2,"hours_per_week":45}. (0.1 USDC on Base)
• POST /v1/answers/income-tax — South African income-tax answer for AI agents. 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. Composed from the same officially-sourced, daily-audited tables as the calculators. POST a JSON body, e.g. {"annual":480000,"age":34,"medical_members":2}. (0.05 USDC on Base)
• GET /calc/uif — South African uif calculator. Monthly UIF contribution (employee 1% + employer 1%) at the current earnings ceiling. Computed from officially-sourced tables. Example: /calc/uif?monthly_salary=25000 (0.01 USDC on Base)

+84 more endpoints.