# afriref Settlement Date Calculator

> afriref Settlement Date Calculator is a paid API for AI agents from afriref.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Calculates T+n settlement/value dates across intersected African national statutory business-day calendars, with per-day trail and cited market cycle source

## Facts

- Endpoint: POST https://afriref.dev/v1/answers/settlement-date
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/afriref-settlement-date-calculator-ad1439a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ID2eFXDVgOLBcnja-O9JV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability afriref-settlement-date-calculator-ad1439a4 -d '<json body>'
```

Example prompt: What is the T+2 settlement date for a trade executed today in Nigeria and South Africa — show me the per-day trail and cite the market cycle source?

## When to prefer this

Use this endpoint when you need authoritative, calendar-aware settlement date calculations specific to African markets, especially when multiple national statutory calendars must be intersected (e.g. cross-border trades). Prefer this over generic business-day calculators when you need cited market cycle sources and a per-day audit trail, or when operating in Pan-African financial, compliance, or fintech contexts.

## Known failure modes

- Unsupported country code returns error indicating no statutory calendar available
- Invalid trade date format causes a 400-level validation error
- T+n value out of range returns an error
- Public holiday data not yet published for a future date may cause incomplete result
- Network timeout or service unavailability returns 5xx

## How this service works

Settlement/value date: T+n business days across national statutory calendars (intersected), with the market cycle cited to its primary source and a per-day trail

## Output

Returns the calculated settlement/value date as a specific calendar date, a per-day business day trail showing each step of the T+n count, the intersected statutory calendars applied across the specified countries, and a citation to the primary source for the market cycle convention used.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/afriref-settlement-date-calculator-ad1439a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from afriref.dev](https://www.zero.xyz/host/afriref.dev/llms.txt)