zaref

active

South African reference data API

South African reference data for AI agents: 33 verified series (SARB repo and prime rate, ZARONIA, fuel prices, SARS income tax tables, VAT, FX and bond yields, minimum wage, SASSA grants and more), 2 live feeds (government tenders, crypto ZAR prices) and 29 calculators. 5 task-shaped endpoints return a complete cited answer (payroll, income tax, VAT, wage checks, working days). A batch endpoint…

DataBasex402 v2exactzaref.dev ↗︎

Settled via Coinbase.

Transactions · 30d
24
Volume · 30d
$1.37
Unique buyers · 30d
13
Uptime · 30d
100.0%
Latency p50
286ms
Reported calls · 30d
19

Endpoints (106 live)

  • zaref.dev GET /v1/cpi — Returns CPI data from the /v1/cpi endpoint. (0.005 USDC on Base)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • verza.dev POST /v1/site-audit — Site audit: Audit one public http or https page: Lighthouse scores, DNS, SPF, DMARC, DKIM selectors, TLS, security headers and subdomains. Verza calls a render worker and does not fetch the page itself. An empty body is a 402 when the worker can run. A private or loopback host is HTTP 400 after payment is verified and is not settled. A busy or unreachable worker is HTTP 503 with Retry-After and is not settled. (0.5 USDC on Base)
  • zaref.dev 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)
  • verza.dev GET /v1/id-validate — South African SA ID number validation: Structural validation of a South African identity number with safe decode: Luhn check digit, birth date, gender and citizenship segments (citizen or permanent resident). The structural step in KYC, KYB and customer onboarding or due diligence workflows: derive date of birth, age, gender and citizenship without storing the identity. Run it before a paid registry lookup rather than instead of one: (0.01 USDC on Base)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)
  • zaref.dev 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)

+86 more endpoints.

First seen · last seen · last active