{"uid":"cap_ID2eFXDVgOLBcnja-O9JV","slug":"afriref-settlement-date-calculator-ad1439a4","name":"afriref Settlement Date Calculator","description":"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","url":"https://afriref.dev/v1/answers/settlement-date?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["trade_date","calendars"],"properties":{"market":{"type":"string","description":"ISO country of the market whose settlement cycle should be applied (with instrument_class)"},"receipt":{"type":"boolean","description":"Optional. true adds an Ed25519 answer receipt on a paid 200, incluedd in this price. Not a certified extract."},"calendars":{"type":"array","items":{"type":"string"},"description":"1-4 calendar ids to intersect: ISO 3166-1 alpha-2 country codes, plus 'eu.t2' for the euro cash leg. The date must be a business day on every one."},"trade_date":{"type":"string","format":"date","description":"Trade/reference date. It is day 0: never counted, never rolled."},"business_days":{"type":"integer","description":"The offset you are trading under (0-30). Supply this, or market + instrument_class to have a cited cycle applied."},"instrument_class":{"enum":["cash_equity","etf","corporate_bond","government_bond","tbill","repo","primary_issuance","other"],"type":"string","description":"Instrument class — a government bond never inherits an equity cycle"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","settlement_date","convention_applied","trail"],"properties":{"trail":{"type":"array","description":"Per-day walk: counted days and skipped days with the reason on each calendar"},"status":{"type":"string"},"caveats":{"type":"array"},"receipt":{"type":"object","description":"Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."},"disclaimer":{"type":"string"},"calendars_used":{"type":"array","description":"Each calendar's basis, weekend rule, coverage and official source"},"settlement_date":{"type":"string","format":"date"},"convention_applied":{"type":"object","description":"The cycle applied, whether it was cited or caller-asserted, its authority tier and citations"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3r57hN8hbf8zbssgN38tv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates T+n settlement/value dates across intersected African national statutory business-day calendars, with per-day trail and cited market cycle source","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Equity trade settlement across two markets","prompt":"A trade was executed today between a Kenyan and South African counterparty under T+3 convention — what is the value date, and show me each business day in the trail accounting for both countries' statutory holidays?"},{"title":"FX forward value date calculation","prompt":"I'm booking an FX forward in Nigeria starting this coming Monday under T+2 — what date does it settle, and are there any public holidays that shift it? I need the per-day trail and the market cycle reference."},{"title":"Bond settlement verification for compliance","prompt":"Verify the settlement date for a bond trade executed on March 28 in Egypt with a T+2 market cycle — intersect the Egyptian statutory calendar and give me the cited source for the convention used."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:00:21.284Z","isFirstParty":false,"canonicalSlug":"afriref-settlement-date-calculator-ad1439a4"}