API reference

The HTTP surface at api.numeraire.dev is currently 21 endpoints across 4 families.

Pricing

• POST /pricing/value — single-position NPV.
• POST /pricing/risk — single-position risk to order 3, per-pillar.
• POST /pricing/cashflows — projected + paid cashflows per leg.
• POST /pricing/portfolio — multi-position priced as one PV.
• POST /pricing/batch — N independent slots in one round-trip.

Handles

• POST /handles/models — upload a PricingModel envelope, get a handle.
• POST /handles/positions — upload a Position envelope, get a handle.
• GET /handles — list handles.
• GET /handles/{handle} — fetch one.

CSA management

• POST /csa-management/csa-versions — create DRAFT CSA version.
• GET /csa-management/csa-versions?as_of=... — resolve effective set.
• GET /csa-management/csa-versions/{csa_key}/history — full timeline.
• GET /csa-management/csa-versions/pending — approval queue.
• PATCH /csa-management/csa-versions/{id}/{approve,reject,tombstone} — state transitions. Approver must differ from creator (4-eyes); enforced server-side, surfaces as AuthError (403) in the client.
• Same 7-route surface mirrored for csa-group-versions.

→ Full request/response shapes per endpoint + curl/Python tabs — coming in v1.3 (rendered from openapi/v1.26.1.json).

The pinned OpenAPI snapshot is available at numeraire-api/openapi/v1.26.1.json.