Polyrankdocs
Strategy Lab

GET /v1/lab/agent/searches/{id}

One of the caller's assistant searches, as its card shows it: what varies and what is fixed, the budget and the windows, the progress, and once it ended the report (N tried, best, median, the deflated statistic, the overfit risk, the single hold-out read) with every variant, losers included. Simulated results. The search card polls it while the search runs. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.

GET
/v1/lab/agent/searches/{id}

One of the caller's assistant searches, as its card shows it: what varies and what is fixed, the budget and the windows, the progress, and once it ended the report (N tried, best, median, the deflated statistic, the overfit risk, the single hold-out read) with every variant, losers included. Simulated results. The search card polls it while the search runs. 404 lab_agent_disabled while LAB_AGENT_ENABLED is off.

Authorization

AuthorizationBearer <token>

API key: Authorization: Bearer pk_live_… (mint at polyrank.app/api-keys)

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/lab/agent/searches/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "search_id": "string",  "status": "proposed",  "strategy_id": "string",  "strategy_name": "string",  "searched": [    "string"  ],  "fixed": [    "string"  ],  "budget_backtests": -9007199254740991,  "minutes": -9007199254740991,  "window": {    "from": "string",    "holdout_from": "string",    "to": "string"  },  "progress": {    "done": -9007199254740991,    "running": -9007199254740991,    "total": -9007199254740991  },  "line": "string",  "verdict": null,  "earlier_backtests_on_holdout": 0,  "best": {    "seq": -9007199254740991,    "params": {      "property1": "string",      "property2": "string"    },    "status": "queued",    "reason": "string",    "per10": 0,    "t": 0,    "copies": -9007199254740991,    "control_per10": 0,    "daily_sharpe": 0  },  "chosen": {    "seq": -9007199254740991,    "params": {      "property1": "string",      "property2": "string"    },    "status": "queued",    "reason": "string",    "per10": 0,    "t": 0,    "copies": -9007199254740991,    "control_per10": 0,    "daily_sharpe": 0  },  "deflated": {    "dsr": 0,    "daily_sharpe": 0,    "luck_sharpe": 0,    "n": -9007199254740991  },  "pbo": {    "pbo": 0,    "splits": -9007199254740991  },  "holdout": {    "per10": 0,    "t": 0,    "copies": -9007199254740991,    "control_per10": 0,    "read_once": true  },  "stop_reason": "string",  "variants": [    {      "seq": -9007199254740991,      "params": {        "property1": "string",        "property2": "string"      },      "status": "queued",      "reason": "string",      "per10": 0,      "t": 0,      "copies": -9007199254740991,      "control_per10": 0,      "daily_sharpe": 0    }  ]}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}
{  "error": "string",  "message": "string",  "feature": "string",  "field": "string",  "plan": "string",  "retry_after_sec": 0,  "retry_after_seconds": 0,  "reason": "string",  "running": 0,  "limit": 0,  "issues": [    null  ],  "trace_id": "string"}

GET /v1/lab/agent/conversations GET

The caller’s assistant conversations, most recent first (at most 100). 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.

GET /v1/lab/agent GET

Whether the caller’s plan includes the Strategy Lab assistant, its budget per UTC day and today’s spend (USD), how many more questions today’s allowance covers at the caller’s median question cost before today (`est_questions_left`, which never rises within a day), today’s spend as a share of the allowance (`used_pct_of_today`), when it resets (`resets_at`, the next midnight UTC), the model, and the notes the page shows with it. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.