Rank candidates
acubic_rank_candidatesRanks the candidates of a design before anything is saved (Order & Select on acubic.ai): the ranked list, page by page, with score, per-factor values (vs industry: also the peers' median), sector, country and asset class, and the pick the site would make. A fresh ranking uses one portfolio generation. The list is kept 1 hour under candidates_id: paging, previewing a pick or re-ranking it cost nothing more, and acubic_create_strategy saves the pick, once per weighting you want to compare. It saves nothing. To count names that pass filters use acubic_screen_universe.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "acubic_rank_candidates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows per page. | |
| cursor | No | A previous next_cursor. | |
| locale | No | The language of this conversation. | |
| include | No | Ids per acubic_list_strategy_options section (index: indices). | |
| ranking | No | A preset: card (acubic_list_strategy_templates). The engine: rank_method or rank_blend. With candidates_id: re-rank that pool. | |
| regions | No | ||
| sectors | No | ||
| recipe_id | No | A recipe id (acubic_list_strategy_options, recipes): sets ranking, sectors, allocation and asset count unless given; your filter_rules add to its own. | |
| experience | No | Legacy: beginner or intermediate with risk_level selects a preset; prefer template_id. Omit for an engine build. | |
| risk_level | No | Preset only (legacy path): largest acceptable drawdown; prefer template_id. | |
| asset_count | No | Number of assets. | |
| template_id | No | An id from acubic_list_strategy_templates: a preset, or advanced for the engine. | |
| filter_rules | No | Each rule: metric, op, value in the metric's own unit. | |
| select_count | No | Top N to select (10, 15, 20, 30 or 50 within the count range; see selection.select_counts). Not with selected_symbols. | |
| asset_classes | No | ||
| candidates_id | No | A ranked list from acubic_rank_candidates (valid 1 hour). | |
| custom_symbols | No | Tickers to add to the pool, checked as on acubic.ai. | |
| locked_symbols | No | Always selected, exempt from every filter. | |
| position_sizing | No | Default: the sizes recommended for the number of assets. | |
| response_format | No | concise | |
| excluded_symbols | No | Names removed from the screened pool (Step 1). | |
| selected_symbols | No | Preview a hand-picked selection of candidates_id (not with allocation or correlation limits). | |
| selection_limits | No | Min/max share of the selection per sector, country or asset class. | |
| asset_count_range | No | Instead of asset_count (default 15 to 25). | |
| client_request_id | No | Idempotency key. | |
| correlation_limit | No | Not offered yet: omit it unless acubic_list_strategy_options shows it offered; then 0.50-0.95, step 0.05 (preset: 0.80). | |
| class_position_sizing | No | Per-asset-class sizes overriding position_sizing. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | ||
| error | No | ||
| counts | No | ||
| quotas | No | ||
| status | No | ||
| ranking | No | ||
| progress | No | ||
| selection | No | ||
| truncated | No | ||
| disclosure | No | ||
| experience | No | ||
| expires_at | No | ||
| risk_level | No | ||
| next_cursor | No | ||
| candidates_id | No | The kept ranked list; acubic_create_strategy and this tool accept it for 1 hour. | |
| custom_symbols | No | ||
| client_request_id | No | The idempotency key this call used (yours, or one made for it). Repeat the call with it to get the same run without a second charge. | |
| quota_unavailable | No | True when the quota counters could not be read after the work was saved; the work is saved. |