fvfair-value
Interface

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

MethodPathDescription
GET/v1/healthService + surface version, tool count
GET/v1/toolsTools with titles, descriptions and methods
GET/v1/methodsFull method catalog (parameters, formula refs, standards)
GET/v1/standardsStandards, clauses, and the methods citing each
GET/v1/openapi.jsonOpenAPI 3.0 document for this API
GET/v1/docsSwagger 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.