alloc_* tool: mean-risk optimisation over 26 risk measures (variance, MAD, CVaR, EVaR, drawdown measures and more), risk parity and risk budgeting, worst-case robust and OWA portfolios, efficient frontiers, hierarchical portfolios (HRP, HERC, NCO), Black-Litterman, factor models and entropy pooling, and the risk analytics of any portfolio: risk tables, risk contributions, drawdowns, attribution and share allocation. It runs on Fincept’s servers; your agent sends numbers or data references and gets back a result envelope with tables and charts.
Fincept Allocation tools are free. They count toward the rate limit only; a
$fincept reference inside a call is charged like a direct call to that tool.Modules
Tools are grouped in modules. Each module is a toolset namedalloc_<module>, so you can list it or search within it. The Fincept Allocation reference lists every module and tool.
alloc_catalog returns the live list of modules and tools from inside your agent.
Inputs
Limits
A computation that runs past its time limit answers
timeout; a busy engine answers busy and the call can be retried a few seconds later.
Outputs
Optimisation tools return the weights and the portfolio’s expected return and risk; risk parity tools add each asset’s or factor’s risk contribution against its budget.alloc_efficient_frontier returns every point as a series with a line chart and the composition as an area chart. Risk tools return tables, with bar charts for contributions and attribution and line and area charts for drawdowns and value paths; estimation tools return covariance and correlation matrices with heatmaps.
Example
Prompt
CVaR portfolio, finds alloc_optimize and alloc_risk_contribution, and passes each asset’s closes as a $fincept reference to market_get_candles, one data column per asset with data_kind: "prices".