REST API
The same engine as the MCP tools, exposed as a versioned REST surface at /v1.
Every call returns the shared envelope — centre value, statistics, solution_type and citations. No method logic is duplicated. The machine-readable contract is served at /v1/openapi.json (Swagger UI at /v1/docs).
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/health | Service + surface version, tool count |
| GET | /v1/tools | Tools with titles, descriptions and methods |
| GET | /v1/methods | Full method catalog (parameters, formula refs, standards) |
| GET | /v1/standards | Standards, clauses, and the methods citing each |
| GET | /v1/openapi.json | OpenAPI 3.0 document for this API |
| GET | /v1/docs | Swagger UI for the API |
| GET | /v1/help/{tool} | Generated transparency record for a tool |
| POST | /v1/calculate/{tool} | Run a method: {"method": "...", ...inputs} |
Example
curl
curl -s -X POST https://fair-value.ascent-partners.com/v1/calculate/calculate_dcf \
-H 'content-type: application/json' \
-d '{"method":"dcf","cash_flows":[100,110],"discount_rate":0.1}'Result envelope
json
{
"status": "ok",
"method": "calculate_dcf.dcf",
"value": 183.4,
"statistics": {
"solution_type": "closed_form",
"distribution": "deterministic",
"centre": 183.4,
"sigma": 0.0,
"percentiles": { "p05": 183.4, "p50": 183.4, "p95": 183.4 },
"samples": null,
"seed": null
},
"solution_type": "closed_form",
"citations": { "ivs": ["IVS.103.A20"], "ifrs": ["IFRS.13.61", "IFRS.13.62"] },
"disclaimer": "..."
}Errors return 400 (invalid method/body) or 404 (unknown tool) with a {"status":"error","error":…} body. Try any method in the playground.