{"d":"M2 14h2"}],["$","path","4cs60a",{"d":"M20 14h2"}],["$","path","1xurst",{"d":"M15 13v2"}],["$","path","rq6x2g",{"d":"M9 13v2"}],"$undefined"]}] 13:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-braces","children":[["$","path","ezmyqa",{"d":"M8 3H7a2 2 0 0 0-2 2v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5c0 1.1.9 2 2 2h1"}],["$","path","e1hn23",{"d":"M16 21h1a2 2 0 0 0 2-2v-5c0-1.1.9-2 2-2a2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1"}],"$undefined"]}] 14:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-flask-conical","children":[["$","path","18mbvz",{"d":"M14 2v6a2 2 0 0 0 .245.96l5.51 10.08A2 2 0 0 1 18 22H6a2 2 0 0 1-1.755-2.96l5.51-10.08A2 2 0 0 0 10 8V2"}],["$","path","3shlmq",{"d":"M6.453 15h11.094"}],["$","path","csnxdl",{"d":"M8.5 2h7"}],"$undefined"]}] 15:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-network","children":[["$","rect","4q2zg0",{"x":"16","y":"16","width":"6","height":"6","rx":"1"}],["$","rect","8cvhb9",{"x":"2","y":"16","width":"6","height":"6","rx":"1"}],["$","rect","1egb70",{"x":"9","y":"2","width":"6","height":"6","rx":"1"}],["$","path","1jsf9p",{"d":"M5 16v-3a1 1 0 0 1 1-1h12a1 1 0 0 1 1 1v3"}],["$","path","2874zd",{"d":"M12 12V8"}],"$undefined"]}] 16:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-globe","children":[["$","circle","1mglay",{"cx":"12","cy":"12","r":"10"}],["$","path","13o1zl",{"d":"M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20"}],["$","path","9i4pu4",{"d":"M2 12h20"}],"$undefined"]}] 17:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-bot","children":[["$","path","hb8ula",{"d":"M12 8V4H8"}],["$","rect","enze0r",{"width":"16","height":"12","x":"4","y":"8","rx":"2"}],["$","path","vft8re",{"d":"M2 14h2"}],["$","path","4cs60a",{"d":"M20 14h2"}],["$","path","1xurst",{"d":"M15 13v2"}],["$","path","rq6x2g",{"d":"M9 13v2"}],"$undefined"]}] 18:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-plug","children":[["$","path","1ega77",{"d":"M12 22v-5"}],["$","path","14iosj",{"d":"M9 8V2"}],["$","path","18g5xt",{"d":"M15 8V2"}],["$","path","osxo6l",{"d":"M18 8v5a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V8Z"}],"$undefined"]}] 19:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-code","children":[["$","polyline","z7tu5w",{"points":"16 18 22 12 16 6"}],["$","polyline","1eg1df",{"points":"8 6 2 12 8 18"}],"$undefined"]}] 1a:["GET /v1/public/copy-engine/funnel"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1b:["GET /v1/public/event/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1c:["GET /v1/public/events/top"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1d:["GET /v1/public/founding"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1e:["GET /v1/public/leaderboard"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 1f:["GET /v1/public/market/{conditionId}/prices"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 20:["GET /v1/public/market/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 21:["GET /v1/public/movers"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 22:["GET /v1/public/newsletter/confirm"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 23:["GET /v1/public/preset-redirects"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 24:["GET /v1/public/pulse"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 25:["GET /v1/public/ranking/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 26:["GET /v1/public/referrer"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 27:["GET /v1/public/reports/smart-money/{week}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 28:["GET /v1/public/reports/smart-money"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 29:["GET /v1/public/search"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2a:["GET /v1/public/t/{tid}/calibration"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2b:["GET /v1/public/t/{tid}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2c:["GET /v1/public/trader/{proxy}/calibration"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2d:["GET /v1/public/trader/{proxy}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2e:["GET /v1/public/trades/top-roi"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 2f:["GET /v1/t/{tid}/resolve"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 30:["GET /v1/traders/recently-active"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 31:["POST /v1/public/newsletter/subscribe"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 32:["GET /v1/trader/{proxy}/activity"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 33:["GET /v1/trader/{proxy}/calibration"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 34:["GET /v1/trader/{proxy}/copy-fitness"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 35:["GET /v1/trader/{proxy}/metrics"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 36:["GET /v1/trader/{proxy}/playbook"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 37:["GET /v1/trader/{proxy}/pnl_curve"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 38:["GET /v1/trader/{proxy}/positions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 39:["GET /v1/trader/{proxy}/return-distribution"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3a:["GET /v1/trader/{proxy}/tags"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3b:["GET /v1/trader/{proxy}/timing-skill"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3c:["GET /v1/trader/{proxy}/trades"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3d:["GET /v1/trader/{proxy}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3e:["GET /v1/event/{slug}/traders"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 3f:["GET /v1/event/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 40:["GET /v1/market/{conditionId}/active-traders"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 41:["GET /v1/market/{conditionId}/concentration"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 42:["GET /v1/market/{conditionId}/fills"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 43:["GET /v1/market/{conditionId}/flow/cohort"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 44:["GET /v1/market/{conditionId}/flow"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 45:["GET /v1/market/{conditionId}/holders"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 46:["GET /v1/market/{conditionId}/liquidity-history"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 47:["GET /v1/market/{conditionId}/prices"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 48:["GET /v1/market/{conditionId}/recap"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 49:["GET /v1/market/{conditionId}/resolution-risk"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 4a:["GET /v1/market/{conditionId}/stats"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 4b:["GET /v1/market/{conditionId}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 4c:["DELETE /v1/rankings/saved/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 4d:["GET /v1/rankings/eval/{preset_id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 4e:["GET /v1/rankings/preset/{slug}/snapshot"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 4f:["GET /v1/rankings/preset/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 50:["GET /v1/rankings/presets"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 51:["GET /v1/rankings/saved/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 52:["GET /v1/rankings/saved"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 53:["PATCH /v1/rankings/saved/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 54:["POST /v1/rankings/custom"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 55:["POST /v1/rankings/saved"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 56:["GET /v1/search"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 57:["GET /v1/compare"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 58:["GET /v1/metrics/catalog"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 59:["GET /v1/metrics/coverage"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5a:["GET /v1/metrics/distribution/{metric}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5b:["GET /v1/stats/overview"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5c:["DELETE /v1/auth/me"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 5d:["GET /v1/auth/email/confirm"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5e:["GET /v1/auth/magic/callback"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 5f:["GET /v1/auth/me/export"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 60:["GET /v1/auth/me"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 61:["PATCH /v1/auth/me"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 62:["POST /v1/auth/email/start"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 63:["POST /v1/auth/email/verify"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 65:["POST /v1/auth/logout-all"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 66:["POST /v1/auth/logout"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 67:["POST /v1/auth/magic/start"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 68:["POST /v1/auth/siwe/nonce"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 69:["POST /v1/auth/siwe/verify"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6a:["POST /v1/auth/terms/accept"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6b:["POST /v1/auth/turnkey/relink"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6c:["POST /v1/auth/ws-token"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 6d:["DELETE /v1/api-keys/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 6e:["GET /v1/api-keys"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 6f:["POST /v1/api-keys"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 70:["DELETE /v1/webhooks/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 71:["GET /v1/webhooks"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 72:["POST /v1/webhooks/{id}/test"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 73:["POST /v1/webhooks"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 74:["PUT /v1/webhooks/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] 75:["DELETE /v1/agent/webhooks/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 76:["GET /v1/agent/catalog"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 77:["GET /v1/agent/compare"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 78:["GET /v1/agent/copy-engine/board"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 79:["GET /v1/agent/copy-engine/funnel"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7a:["GET /v1/agent/copy-engine/methodology"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7b:["GET /v1/agent/credits/balance"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7c:["GET /v1/agent/event/{slug}/traders"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7d:["GET /v1/agent/event/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7e:["GET /v1/agent/events/top"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 7f:["GET /v1/agent/identity/{proxy}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 80:["GET /v1/agent/leaderboard"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 81:["GET /v1/agent/market/{conditionId}/active-traders"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 82:["GET /v1/agent/market/{conditionId}/concentration"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 83:["GET /v1/agent/market/{conditionId}/fills"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 84:["GET /v1/agent/market/{conditionId}/flow/cohort"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 85:["GET /v1/agent/market/{conditionId}/flow"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 86:["GET /v1/agent/market/{conditionId}/holders"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 87:["GET /v1/agent/market/{conditionId}/liquidity-history"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 88:["GET /v1/agent/market/{conditionId}/positioning"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 89:["GET /v1/agent/market/{conditionId}/prices"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8a:["GET /v1/agent/market/{conditionId}/recap"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8b:["GET /v1/agent/market/{conditionId}/resolution-risk"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8c:["GET /v1/agent/market/{conditionId}/stats"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8d:["GET /v1/agent/market/{conditionId}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8e:["GET /v1/agent/metrics/catalog"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 8f:["GET /v1/agent/metrics/coverage"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 90:["GET /v1/agent/metrics/distribution/{metric}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 91:["GET /v1/agent/metrics/windows"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 92:["GET /v1/agent/movers"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 93:["GET /v1/agent/pulse"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 94:["GET /v1/agent/rankings/goals"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 95:["GET /v1/agent/rankings/preset/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 96:["GET /v1/agent/rankings/presets"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 97:["GET /v1/agent/rankings/published/{slug}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 98:["GET /v1/agent/reports/smart-money/{week}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 99:["GET /v1/agent/resolutions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9a:["GET /v1/agent/search"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9b:["GET /v1/agent/signals/smart-money"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9c:["GET /v1/agent/stats"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9d:["GET /v1/agent/trader/{proxy}/activity"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9e:["GET /v1/agent/trader/{proxy}/calibration"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 9f:["GET /v1/agent/trader/{proxy}/copy-fitness"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a0:["GET /v1/agent/trader/{proxy}/metrics"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a1:["GET /v1/agent/trader/{proxy}/playbook"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a2:["GET /v1/agent/trader/{proxy}/pnl-curve"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a3:["GET /v1/agent/trader/{proxy}/position-changes"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a4:["GET /v1/agent/trader/{proxy}/positions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a5:["GET /v1/agent/trader/{proxy}/predictor"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a6:["GET /v1/agent/trader/{proxy}/return-distribution"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a7:["GET /v1/agent/trader/{proxy}/tags"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a8:["GET /v1/agent/trader/{proxy}/timing-skill"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] a9:["GET /v1/agent/trader/{proxy}/trades"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] aa:["GET /v1/agent/trader/{proxy}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ab:["GET /v1/agent/traders/recently-active"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ac:["GET /v1/agent/trades/top-roi"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ad:["GET /v1/agent/webhooks"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ae:["POST /v1/agent/credits/deposit"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] af:["POST /v1/agent/markets/batch"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] b0:["POST /v1/agent/rankings/custom"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] b1:["POST /v1/agent/traders/batch"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] b2:["POST /v1/agent/webhooks"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] b3:["POST /v1/agent/ws-token"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] b4:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-code","children":[["$","polyline","z7tu5w",{"points":"16 18 22 12 16 6"}],["$","polyline","1eg1df",{"points":"8 6 2 12 8 18"}],"$undefined"]}] b5:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-radio","children":[["$","path","1vaf9d",{"d":"M4.9 19.1C1 15.2 1 8.8 4.9 4.9"}],["$","path","u1ii0m",{"d":"M7.8 16.2c-2.3-2.3-2.3-6.1 0-8.5"}],["$","circle","1c9p78",{"cx":"12","cy":"12","r":"2"}],["$","path","1j5fej",{"d":"M16.2 7.8c2.3 2.3 2.3 6.1 0 8.5"}],["$","path","10b0cb",{"d":"M19.1 4.9C23 8.8 23 15.1 19.1 19"}],"$undefined"]}] b6:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-webhook","children":[["$","path","q3hayz",{"d":"M18 16.98h-5.99c-1.1 0-1.95.94-2.48 1.9A4 4 0 0 1 2 17c.01-.7.2-1.4.57-2"}],["$","path","1go1hn",{"d":"m6 17 3.13-5.78c.53-.97.1-2.18-.5-3.1a4 4 0 1 1 6.89-4.06"}],["$","path","qlwsc0",{"d":"m12 6 3.13 5.73C15.66 12.7 16.9 13 18 13a4 4 0 0 1 0 8"}],"$undefined"]}] b7:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-gavel","children":[["$","path","15492f",{"d":"m14.5 12.5-8 8a2.119 2.119 0 1 1-3-3l8-8"}],["$","path","vzrcl6",{"d":"m16 16 6-6"}],["$","path","18bi4p",{"d":"m8 8 6-6"}],["$","path","5jnvq1",{"d":"m9 7 8 8"}],["$","path","z4y7zo",{"d":"m21 11-8-8"}],"$undefined"]}] b8:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-flag","children":[["$","path","i9b6wo",{"d":"M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"}],["$","line","1cm3nv",{"x1":"4","x2":"4","y1":"22","y2":"15"}],"$undefined"]}] b9:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-clock","children":[["$","circle","1mglay",{"cx":"12","cy":"12","r":"10"}],["$","polyline","68esgv",{"points":"12 6 12 12 16 14"}],"$undefined"]}] ba:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-trending-up","children":[["$","polyline","126l90",{"points":"22 7 13.5 15.5 8.5 10.5 2 17"}],["$","polyline","kwv8wd",{"points":"16 7 22 7 22 13"}],"$undefined"]}] bb:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-flag","children":[["$","path","i9b6wo",{"d":"M4 15s1-1 4-1 5 2 8 2 4-1 4-1V3s-1 1-4 1-5-2-8-2-4 1-4 1z"}],["$","line","1cm3nv",{"x1":"4","x2":"4","y1":"22","y2":"15"}],"$undefined"]}] bc:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-book-open","children":[["$","path","1akyts",{"d":"M12 7v14"}],["$","path","ruj8y",{"d":"M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z"}],"$undefined"]}] bd:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-credit-card","children":[["$","rect","ynyp8z",{"width":"20","height":"14","x":"2","y":"5","rx":"2"}],["$","line","1b3vmo",{"x1":"2","x2":"22","y1":"10","y2":"10"}],"$undefined"]}] be:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-book-a","children":[["$","path","k3hazp",{"d":"M4 19.5v-15A2.5 2.5 0 0 1 6.5 2H19a1 1 0 0 1 1 1v18a1 1 0 0 1-1 1H6.5a1 1 0 0 1 0-5H20"}],["$","path","4rari8",{"d":"m8 13 4-7 4 7"}],["$","path","1gkovt",{"d":"M9.1 11h5.7"}],"$undefined"]}] bf:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-circle-help","children":[["$","circle","1mglay",{"cx":"12","cy":"12","r":"10"}],["$","path","1u773s",{"d":"M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"}],["$","path","p32p05",{"d":"M12 17h.01"}],"$undefined"]}] c0:["$","svg",null,{"ref":"$undefined","xmlns":"http://www.w3.org/2000/svg","width":24,"height":24,"viewBox":"0 0 24 24","fill":"none","stroke":"currentColor","strokeWidth":2,"strokeLinecap":"round","strokeLinejoin":"round","className":"lucide lucide-history","children":[["$","path","1357e3",{"d":"M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8"}],["$","path","1xhq8a",{"d":"M3 3v5h5"}],["$","path","1fdv2h",{"d":"M12 7v5l4 2"}],"$undefined"]}] c1:["DELETE /v1/alerts/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] c2:["DELETE /v1/telegram/link"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] c3:["GET /v1/alerts/allowance"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] c4:["GET /v1/alerts/settings"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] c5:["GET /v1/alerts"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] c6:["GET /v1/notifications/prefs"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] c7:["GET /v1/notifications/unread-count"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] c8:["GET /v1/notifications"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] c9:["GET /v1/telegram"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ca:["PATCH /v1/alerts/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] cb:["POST /v1/alerts"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] cc:["POST /v1/notifications/read"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] cd:["POST /v1/notifications/unsubscribe"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] ce:["POST /v1/telegram/link"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] cf:["POST /v1/telegram/test"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] d0:["PUT /v1/alerts/settings"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] d1:["PUT /v1/notifications/prefs"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] d2:["PUT /v1/telegram/prefs"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] d3:["GET /v1/copy-engine/board"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] d4:["GET /v1/copy-engine/methodology"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] d5:["GET /v1/feedback/attachments/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] d6:["POST /v1/feedback"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] d7:["DELETE /v1/follows/{type}/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] d8:["GET /v1/follows/recent-fills"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] d9:["GET /v1/follows"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] da:["PATCH /v1/follows/{type}/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] db:["POST /v1/follows"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] dc:["DELETE /v1/lab/agent/conversations/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] dd:["DELETE /v1/lab/strategies/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] de:["GET /v1/lab/agent/conversations/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] df:["GET /v1/lab/agent/conversations/{id}/events"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e0:["GET /v1/lab/agent/conversations"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e1:["GET /v1/lab/agent"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e2:["GET /v1/lab/backtests/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e3:["GET /v1/lab/backtests"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e4:["GET /v1/lab/limits"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e5:["GET /v1/lab/notify"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e6:["GET /v1/lab/paper-runs/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e7:["GET /v1/lab/paper-runs"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e8:["GET /v1/lab/strategies/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] e9:["GET /v1/lab/strategies/cleanup"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ea:["GET /v1/lab/strategies"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] eb:["GET /v1/lab/templates"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ec:["PATCH /v1/lab/agent/conversations/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] ed:["PATCH /v1/lab/backtests/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] ee:["PATCH /v1/lab/strategies/{id}"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] ef:["POST /v1/lab/agent/conversations/{id}/messages"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f0:["POST /v1/lab/agent/conversations/{id}/stop"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f1:["POST /v1/lab/agent/conversations"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f2:["POST /v1/lab/backtests"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f4:["POST /v1/lab/paper-runs/{id}/stop"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f5:["POST /v1/lab/strategies/cleanup"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f6:["POST /v1/lab/strategies/{id}/paper"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f7:["POST /v1/lab/strategies"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] f8:["PUT /v1/lab/paper-runs/{id}/notify"," ",["$","span",null,{"className":"font-mono font-medium text-yellow-600 dark:text-yellow-400 ms-auto text-xs text-nowrap","children":"PUT"}]] f9:["GET /v1/meta/flags"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] fa:["GET /v1/meta/freshness"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] fb:["POST /v1/client-errors"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] fc:["DELETE /v1/profile/claim/{proxy}"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] fd:["GET /v1/profile/claim/{proxy}/eligibility"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] fe:["GET /v1/profile/claimable"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] ff:["GET /v1/profile/claims"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 100:["POST /v1/profile/claim/{proxy}/challenge"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 101:["POST /v1/profile/claim/{proxy}"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 102:["DELETE /v1/push/subscribe"," ",["$","span",null,{"className":"font-mono font-medium text-red-600 dark:text-red-400 ms-auto text-xs text-nowrap","children":"DELETE"}]] 103:["GET /v1/push/vapid-public-key"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 104:["POST /v1/push/subscribe"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 105:["GET /v1/redeem/{code}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 106:["POST /v1/redeem/{code}"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 107:["GET /v1/referral/commissions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 108:["GET /v1/referral/me"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 109:["GET /v1/referral/payouts"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 10a:["GET /v1/referral/resolve/{code}"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 10b:["PATCH /v1/referral/code"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 10c:["POST /v1/referral/bind"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 10d:["POST /v1/referral/payout-request"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 10e:["POST /v1/referral/track-view"," ",["$","span",null,{"className":"font-mono font-medium text-blue-600 dark:text-blue-400 ms-auto text-xs text-nowrap","children":"POST"}]] 10f:["GET /v1/resolutions"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 110:["GET /v1/user-prefs"," ",["$","span",null,{"className":"font-mono font-medium text-green-600 dark:text-green-400 ms-auto text-xs text-nowrap","children":"GET"}]] 111:["PATCH /v1/user-prefs"," ",["$","span",null,{"className":"font-mono font-medium text-orange-600 dark:text-orange-400 ms-auto text-xs text-nowrap","children":"PATCH"}]] 112:["$","div",null,{"className":"size-full [&_svg]:size-full max-md:p-1.5 max-md:rounded-md max-md:border max-md:bg-fd-secondary","children":"$17"}] 113:["$","div",null,{"className":"size-full [&_svg]:size-full max-md:p-1.5 max-md:rounded-md max-md:border max-md:bg-fd-secondary","children":"$b4"}] 114:["$","span",null,{"className":"flex items-center gap-2 font-semibold tracking-tight","children":[["$","span",null,{"aria-hidden":true,"style":{"color":"#00d4ff"},"children":"●"}],["$","span",null,{"children":"Polyrank"}],["$","span",null,{"className":"rounded border border-fd-border px-1.5 py-px font-mono text-[10px] uppercase tracking-[0.2em] text-fd-muted-foreground","children":"docs"}]]}] 115:["$","$L3",null,{"parallelRouterKey":"children","error":"$undefined","errorStyles":"$undefined","errorScripts":"$undefined","template":["$","$L4",null,{}],"templateStyles":"$undefined","templateScripts":"$undefined","notFound":[[["$","title",null,{"children":"404: This page could not be found."}],["$","div",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:0:props:children:0:props:notFound:0:1:props:style","children":["$","div",null,{"children":[["$","style",null,{"dangerouslySetInnerHTML":{"__html":"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}"}}],["$","h1",null,{"className":"next-error-h1","style":"$0:f:0:1:0:props:children:1:props:children:props:children:0:props:children:0:props:notFound:0:1:props:children:props:children:1:props:style","children":404}],["$","div",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:0:props:children:0:props:notFound:0:1:props:children:props:children:2:props:style","children":["$","h2",null,{"style":"$0:f:0:1:0:props:children:1:props:children:props:children:0:props:children:0:props:notFound:0:1:props:children:props:children:2:props:children:props:style","children":"This page could not be found."}]}]]}]}]],[]],"forbidden":"$undefined","unauthorized":"$undefined"}] 123:T483,Check the 6-digit code from POST /v1/auth/email/start. On success the address is the account's confirmed email. A failure is a 400 `email_code_failed` with `reason`: `invalid_code` (with `attempts_left`), `expired`, `too_many_attempts` (after 5: ask for a new code), `no_pending`, or `unavailable` (the right code, but another account confirmed the address meanwhile). Wrong codes are also capped per DAY (20 per account, 20 per address): past a cap the answer is a 429 `email_code_failed`. Past the ACCOUNT's cap the `reason` is `rate_limited`, with `retry_after_seconds` and `Retry-After`: nothing is compared and the code keeps its attempts. Past the ADDRESS's cap (other accounts can spend it) a code that was never tried is still compared once, so the right code of a FRESH start passes; any other try (a code that was already tried, or a wrong first try) is a 429 with `reason` `new_code_required` and no `retry_after_seconds` or `Retry-After`: that code can no longer be used, and the remedy is a new code from POST /v1/auth/email/start, not a wait. A code that was already tried is refused without being compared and without costing it an attempt.124:T452,Queue a backtest of one of the caller’s strategies (strategy_id) or of an unsaved spec, over [from, to) (at most 366 days), optionally with explicit re-rank cuts. Answers 202 with the run; poll GET /lab/backtests/:id. The spec and a Builder source’s config are frozen into the run. Results are SIMULATED: every report names its fill model and the measured optimism. A strategy that copies no wallet (own rules, Quant and above) is tested on the recorded order books: 400 `rules_before_book_history` for a window before 2026-07-23; its report covers the first three quarters of the window unless final_test asks for the sealed last quarter (400 `final_test_rules_only` for a copy strategy; 400 `final_test_needs_strategy` for an unsaved spec; 409 `final_test_already_run` once the strategy’s final test was run — once per strategy, a failed run aside). 403 `plan_required` (strategy_lab; own rules); 429 `lab_daily_limit` at the plan’s backtests per UTC day (Retry-After = seconds to midnight UTC); 429 `lab_busy` with 3 runs already queued or running. 404 `lab_disabled` while LAB_ENABLED is off.116:["$","$L11e",null,{"toc":[],"full":true,"children":[["$","$L11f",null,{"children":"GET /v1/agent/catalog"}],["$","$L120",null,{"children":"Free (no payment)."}],["$","$L121",null,{"children":["$","$L122",null,{"payload":{"bundled":{"openapi":"3.2.0","info":{"title":"Polyrank API","description":"Skill analytics for Polymarket traders — calibration (Brier), alpha-vs-mid, risk-adjusted return across ~2.9M wallets. Anonymous `/v1/public/*` teaser namespace plus session- or API-key-authed `/v1/*` routes.","version":"1.0.0","contact":{"name":"Polyrank","url":"https://docs.polyrank.app"}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API key: `Authorization: Bearer pk_live_…` (mint at polyrank.app/api-keys)"},"sessionCookie":{"type":"apiKey","in":"cookie","name":"__Secure-polyrank_sid","description":"Browser session cookie set by the sign-in flow"},"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 payment: base64(JSON PaymentPayload) with an EIP-3009 USDC transferWithAuthorization on Base. Call once without it to get the 402 PaymentRequirements; see docs.polyrank.app/x402."}},"schemas":{}},"paths":{"/v1/auth/siwe/nonce":{"post":{"tags":["auth"],"description":"Issue a SIWE nonce. Single-use, 5-minute TTL.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"nonce":{"type":"string"},"expires_at":{"type":"string"}},"required":["nonce","expires_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-siwe-nonce","summary":"POST /v1/auth/siwe/nonce"}},"/v1/auth/siwe/verify":{"post":{"tags":["auth"],"description":"Verify a SIWE message + signature. Issues a session cookie on success.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","maxLength":4096},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$"},"turnkey_session":{"type":"string","minLength":1,"maxLength":4096},"terms_version":{"type":"string","maxLength":32}},"required":["message","signature"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"user_id":{"type":"string"},"eoa":{"type":"string"},"expires_at":{"type":"string"},"is_new":{"type":"boolean","description":"True only when this call created the account (a first sign-in). False for a returning user, and for an embedded-wallet sign-in that was folded into an existing email account."}},"required":["ok","user_id","eoa","expires_at","is_new"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-siwe-verify","summary":"POST /v1/auth/siwe/verify"}},"/v1/auth/magic/start":{"post":{"tags":["auth"],"description":"Send a magic-link email. Rate-limited per caller + per email: a 429 carries `retry_after_seconds` and the `Retry-After` header. When the Turnstile check is enforced, a missing / refused / unverifiable `turnstile_token` is a 400 `bad_request` with `reason` `turnstile_missing` / `turnstile_failed` / `turnstile_unavailable`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"next":{"type":"string","maxLength":512,"pattern":"^\\/(?![/\\\\])"},"turnstile_token":{"type":"string","maxLength":2048},"terms_version":{"type":"string","maxLength":32}},"required":["email"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"dev_link":{"type":"string"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-magic-start","summary":"POST /v1/auth/magic/start"}},"/v1/auth/magic/callback":{"get":{"tags":["auth"],"description":"Consume a magic-link token. Issues a session cookie + redirects to the destination (default /home); `welcome=1` is added to it only when this call created the account. A failed link (expired / already_used / invalid_token) is a 401, or, when MAGIC_LINK_ERROR_REDIRECT=1, a 302 to the web page /auth/link?error= (no token in it).","parameters":[{"schema":{"type":"string"},"in":"query","name":"token","required":true}],"responses":{"302":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-auth-magic-callback","summary":"GET /v1/auth/magic/callback"}},"/v1/auth/logout":{"post":{"tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-logout","summary":"POST /v1/auth/logout"}},"/v1/auth/logout-all":{"post":{"tags":["auth"],"description":"Revoke all sessions for the current user (sign out everywhere).","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"revoked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["ok","revoked"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-logout-all","summary":"POST /v1/auth/logout-all"}},"/v1/auth/me":{"get":{"tags":["auth"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"anyOf":[{"type":"object","properties":{"user_id":{"type":"string"},"eoa":{"type":["string","null"]},"email":{"type":["string","null"]},"email_confirmed":{"type":"boolean"},"pending_email":{"type":["string","null"]},"terms":{"type":"object","properties":{"accepted":{"type":"boolean","description":"This account accepted the CURRENT version."},"version":{"description":"The version it last accepted; null = never.","type":["string","null"]},"current":{"type":"string","description":"The current terms version (TERMS_VERSION)."}},"required":["accepted","version","current"],"additionalProperties":false},"sign_in":{"type":"object","properties":{"turnkey":{"type":["boolean","null"]}},"required":["turnkey"],"additionalProperties":false},"display_name":{"type":["string","null"]},"x_username":{"type":["string","null"]},"created_at":{"type":"string"},"claimed_proxy_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"primary_claimed_proxy":{"type":["string","null"]},"is_founding":{"type":"boolean"}},"required":["user_id","eoa","email","email_confirmed","pending_email","terms","sign_in","display_name","x_username","created_at","claimed_proxy_count","primary_claimed_proxy","is_founding"],"additionalProperties":false},{"type":"null"}]}},"required":["user"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-auth-me","summary":"GET /v1/auth/me"},"patch":{"tags":["auth"],"description":"Update the current user’s display name, email, and/or X handle. With EMAIL_CONFIRMATION_ENABLED=1 this route never sets an address: `email:

` is a 409 `conflict` with `reason: use_email_code` (confirm it with POST /v1/auth/email/start and /verify; an address equal to the account’s current email is ignored). `email: null` removes the email (and any pending one) as before; the previous address gets a notice.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"email":{"anyOf":[{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"x_username":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"user_id":{"type":"string"},"eoa":{"type":["string","null"]},"email":{"type":["string","null"]},"display_name":{"type":["string","null"]},"x_username":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["user_id","eoa","email","display_name","x_username","created_at"],"additionalProperties":false}},"required":["user"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-auth-me","summary":"PATCH /v1/auth/me"},"delete":{"tags":["auth"],"description":"Permanently delete (anonymize) your account. Irreversible.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm":{"type":"boolean","enum":[true]}},"required":["confirm"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","enum":[true]}},"required":["deleted"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-auth-me","summary":"DELETE /v1/auth/me"}},"/v1/auth/email/start":{"post":{"tags":["auth"],"description":"Mail a 6-digit code (10 minutes, 5 attempts) to confirm an email for the signed-in account. Always `{ ok: true, expires_in_seconds }` for a well-formed address, whether or not it already belongs to another account (an owner who CONFIRMED the address gets a notice instead of a code; an address that sits unconfirmed on another wallet account does not block the code, and the right code moves the address to the account that proved the inbox). The mail is sent after the response, so the answer never says whether it was delivered: to RESEND, call this route again; it mails a FRESH code and the previous one stops working. Rate-limited per caller, per account and per address over 5 minutes, and per account and per address over a DAY (10 codes each): a 429 carries `retry_after_seconds` and `Retry-After`. 404 `email_confirmation_disabled` while EMAIL_CONFIRMATION_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"already_confirmed":{"type":"boolean"},"expires_in_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dev_code":{"type":"string"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-email-start","summary":"POST /v1/auth/email/start"}},"/v1/auth/email/verify":{"post":{"tags":["auth"],"description":"$123","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","pattern":"^\\d{6}$"},"terms_version":{"type":"string","maxLength":32}},"required":["code"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"email":{"type":"string"}},"required":["ok","email"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"},"attempts_left":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-email-verify","summary":"POST /v1/auth/email/verify"}},"/v1/auth/terms/accept":{"post":{"tags":["auth"],"description":"Record that the signed-in account accepts the terms. `version` must be the current one (GET /v1/auth/me `terms.current`); another value is a 400 `terms_version_mismatch` carrying `current`. Accepting twice keeps the first timestamp. Nothing is blocked on acceptance.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":32}},"required":["version"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"terms":{"type":"object","properties":{"accepted":{"type":"boolean","description":"This account accepted the CURRENT version."},"version":{"description":"The version it last accepted; null = never.","type":["string","null"]},"current":{"type":"string","description":"The current terms version (TERMS_VERSION)."}},"required":["accepted","version","current"],"additionalProperties":false}},"required":["ok","terms"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"},"current":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-terms-accept","summary":"POST /v1/auth/terms/accept"}},"/v1/auth/email/confirm":{"get":{"tags":["auth"],"description":"Behind EMAIL_CONFIRM_LINK_ENABLED (default off: 404 `email_confirm_link_disabled`; no route mails such a link). Consume an email confirmation link (single use). Always a 302 to the web page /auth/link: `?confirmed=1` on success, `?error=expired | used | invalid` otherwise. No token in the redirect; no session is issued.","parameters":[{"schema":{"type":"string","maxLength":4096},"in":"query","name":"token","required":true}],"responses":{"302":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-auth-email-confirm","summary":"GET /v1/auth/email/confirm"}},"/v1/auth/turnkey/relink":{"post":{"tags":["auth"],"description":"Re-run the Turnkey email link for the signed-in account, after an email was added and verified in Turnkey. `turnkey_session` is the kit session JWT (`Session.token`). Answers `{ ok: true, merged }` when the email is now on this account and `{ ok: false }` when it was kept separate, without saying why. Session only (not an API key). Rate-limited per caller and per account: a 429 carries `retry_after_seconds`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"turnkey_session":{"type":"string","minLength":1,"maxLength":4096}},"required":["turnkey_session"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","description":"The verified Turnkey email is on this account now."},"merged":{"description":"Present when ok: an existing email-only account was joined into this one.","type":"boolean"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-turnkey-relink","summary":"POST /v1/auth/turnkey/relink"}},"/v1/auth/me/export":{"get":{"tags":["auth"],"description":"Export all of your account data as JSON (GDPR).","responses":{"200":{"description":"Default Response"}},"operationId":"get-auth-me-export","summary":"GET /v1/auth/me/export"}},"/v1/auth/ws-token":{"post":{"tags":["auth"],"description":"Exchange the session cookie for a short-lived WSS JWT.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"expires_in":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["token","expires_in"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-auth-ws-token","summary":"POST /v1/auth/ws-token"}},"/v1/rankings/custom":{"post":{"tags":["rankings"],"description":"Compute a composite ranking over the wallet cohort with user-supplied weights and filters. The composite score is a weighted sum of percentile ranks across the chosen metrics; weights are auto-normalized. Paid feature (Builder).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]},"weight":{"type":"number","minimum":0,"maximum":1000}},"required":["metric","weight"]}}]},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"include_breakdown":{"default":false,"type":"boolean"},"include_verdict":{"default":false,"type":"boolean"},"extra_metrics":{"maxItems":60,"type":"array","items":{"type":"string"}},"extra_engine_metrics":{"maxItems":12,"type":"array","items":{"type":"string"}},"include_raw":{"default":false,"type":"boolean"},"sort_by":{"default":"composite","type":"string","maxLength":80},"sort_dir":{"default":"desc","type":"string","enum":["desc","asc"]},"explain":{"default":false,"type":"boolean"},"include_cluster":{"default":false,"type":"boolean"},"dedupe_clusters":{"default":false,"type":"boolean"},"c19_cap":{"type":"number","minimum":0,"maximum":1000000},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["weights"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"proxy_wallet":{"type":"string"},"user_id":{"type":"string"},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"wallets":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"realized_pnl":{"type":"number"},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false}},"required":["proxy_wallet","realized_pnl","lifetime_volume_usdc","trade_count","win_rate_pct"],"additionalProperties":false}},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"composite_score":{"type":"number"},"lifetime_volume_usdc":{"type":"number"},"realized_pnl":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"profit_per_dollar_risked":{"type":["number","null"]},"return_on_avg_capital":{"type":["number","null"]},"pnl_net_usdc":{"type":["number","null"]},"roi_net":{"type":["number","null"]},"prediction_accuracy_pct":{"type":["number","null"]},"prediction_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"prediction_avg_price":{"type":["number","null"]},"brier":{"type":["number","null"]},"last_trade_at":{"type":["string","null"]},"last_fill_at":{"type":["string","null"]},"breakdown":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"raw":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"engine":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"breakdown_measured":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"boolean"}},"verdict":{"anyOf":[{"type":"object","properties":{"overall":{"type":["number","null"]},"tone":{"type":"string","enum":["good","caution","danger","neutral"]},"title":{"type":"string"},"topTag":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"tone":{"type":"string","enum":["good","caution","danger","neutral"]},"title":{"type":"string"}},"required":["label","tone","title"],"additionalProperties":false},{"type":"null"}]},"copyRecommended":{"type":"boolean"},"copiesBadly":{"type":"boolean"}},"required":["overall","tone","title","topTag","copyRecommended","copiesBadly"],"additionalProperties":false},{"type":"null"}]},"cluster_id":{"type":["string","null"]},"cluster_size":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["rank","proxy_wallet","composite_score","lifetime_volume_usdc","realized_pnl","trade_count","markets_traded","win_rate_pct","brier","last_trade_at"],"additionalProperties":false}},"total_rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cohort_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Wallets this board RANKS — the post-gate count, equal to total_rows. ⚠️ CHANGED 2026-09-03: it previously meant the window-eligible universe (every wallet with a trade in the window — the same ~3.1M on every board). If you were reading it as a population figure, read `eligible_universe` instead."},"eligible_universe":{"description":"Wallets eligible in this window before the board’s own gates — the population, and the same number on every board. Optional: board bodies cached by an API image older than 2026-09-03 do not carry it.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"normalized_weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"gated_out_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"query_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applied_filters":{"type":"object","properties":{"active_within_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"rows_capped_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"preset_redirect":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},"dropped_weights":{"type":"array","items":{"type":"string"}},"dropped_gates":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["skill_gate","metric_filter"]},"metric":{"type":"string"},"window":{"type":"string"},"reason":{"type":"string"}},"required":["kind","metric","window","reason"],"additionalProperties":false}},"effective_weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"grain":{"type":"string","enum":["wallet","user"]},"explain":{"type":"object","properties":{"cohort_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"gates":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"condition":{"type":"string"},"dropped":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["label","condition","dropped","remaining"],"additionalProperties":false}}},"required":["cohort_size","gates"],"additionalProperties":false}},"required":["rows","total_rows","cohort_size","normalized_weights","gated_out_count","query_ms","snapshot_age_seconds"],"additionalProperties":false}}}}},"operationId":"post-rankings-custom","summary":"POST /v1/rankings/custom","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/rankings/presets":{"get":{"tags":["rankings"],"description":"List the active leaderboard presets (slug, name, description and its parts, config).","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"presets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"sort_order":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight","window"],"additionalProperties":false}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"required":["sleeve"],"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","window","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile","window"],"additionalProperties":false}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","window"],"additionalProperties":false}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["version","weights","filters","na_policy","preset_id","created_via_preset_id"],"additionalProperties":false},"effective_weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"dropped_weights":{"type":"array","items":{"type":"string"}},"board_group":{"type":"string"},"column_set":{"type":"string"},"description_parts":{"type":"object","properties":{"promise":{"type":"string","minLength":1},"rules":{"type":"string","minLength":1},"result":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"setting":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["promise","rules","result","setting"],"additionalProperties":false}},"required":["id","name","description","sort_order","config"],"additionalProperties":false}}},"required":["presets"],"additionalProperties":false}}}}},"operationId":"get-rankings-presets","summary":"GET /v1/rankings/presets","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/rankings/preset/{slug}":{"get":{"tags":["rankings"],"description":"Top-N for a named preset. Cached for 60 seconds. Optional active_within_days / active_within_hours / best_category / sort_by overrides, and extra_metrics (comma-separated ids) for per-row breakdown columns (paid).","parameters":[{"schema":{"default":100,"type":"integer","minimum":1,"maximum":500},"in":"query","name":"limit","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"in":"query","name":"offset","required":false},{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"include_breakdown","required":false,"description":"true / false / 1 / 0"},{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"include_verdict","required":false,"description":"true / false / 1 / 0"},{"schema":{"type":"integer","minimum":1,"maximum":3650},"in":"query","name":"active_within_days","required":false},{"schema":{"type":"integer","minimum":1,"maximum":168},"in":"query","name":"active_within_hours","required":false},{"schema":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"in":"query","name":"best_category","required":false},{"schema":{"default":"composite","type":"string","maxLength":80},"in":"query","name":"sort_by","required":false},{"schema":{"default":"desc","type":"string","enum":["desc","asc"]},"in":"query","name":"sort_dir","required":false},{"schema":{"type":"string","maxLength":600},"in":"query","name":"extra_metrics","required":false},{"schema":{"type":"string","maxLength":300},"in":"query","name":"extra_engine_metrics","required":false},{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"include_cluster","required":false,"description":"true / false / 1 / 0"},{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"dedupe_clusters","required":false,"description":"true / false / 1 / 0"},{"schema":{"type":"string","maxLength":64,"pattern":"^[a-z0-9-]+$"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"proxy_wallet":{"type":"string"},"user_id":{"type":"string"},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"wallets":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"realized_pnl":{"type":"number"},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false}},"required":["proxy_wallet","realized_pnl","lifetime_volume_usdc","trade_count","win_rate_pct"],"additionalProperties":false}},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"composite_score":{"type":"number"},"lifetime_volume_usdc":{"type":"number"},"realized_pnl":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"profit_per_dollar_risked":{"type":["number","null"]},"return_on_avg_capital":{"type":["number","null"]},"pnl_net_usdc":{"type":["number","null"]},"roi_net":{"type":["number","null"]},"prediction_accuracy_pct":{"type":["number","null"]},"prediction_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"prediction_avg_price":{"type":["number","null"]},"brier":{"type":["number","null"]},"last_trade_at":{"type":["string","null"]},"last_fill_at":{"type":["string","null"]},"breakdown":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"raw":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"engine":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"breakdown_measured":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"boolean"}},"verdict":{"anyOf":[{"type":"object","properties":{"overall":{"type":["number","null"]},"tone":{"type":"string","enum":["good","caution","danger","neutral"]},"title":{"type":"string"},"topTag":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"tone":{"type":"string","enum":["good","caution","danger","neutral"]},"title":{"type":"string"}},"required":["label","tone","title"],"additionalProperties":false},{"type":"null"}]},"copyRecommended":{"type":"boolean"},"copiesBadly":{"type":"boolean"}},"required":["overall","tone","title","topTag","copyRecommended","copiesBadly"],"additionalProperties":false},{"type":"null"}]},"cluster_id":{"type":["string","null"]},"cluster_size":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["rank","proxy_wallet","composite_score","lifetime_volume_usdc","realized_pnl","trade_count","markets_traded","win_rate_pct","brier","last_trade_at"],"additionalProperties":false}},"total_rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cohort_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Wallets this board RANKS — the post-gate count, equal to total_rows. ⚠️ CHANGED 2026-09-03: it previously meant the window-eligible universe (every wallet with a trade in the window — the same ~3.1M on every board). If you were reading it as a population figure, read `eligible_universe` instead."},"eligible_universe":{"description":"Wallets eligible in this window before the board’s own gates — the population, and the same number on every board. Optional: board bodies cached by an API image older than 2026-09-03 do not carry it.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"normalized_weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"gated_out_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"query_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"applied_filters":{"type":"object","properties":{"active_within_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"rows_capped_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"preset_redirect":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},"dropped_weights":{"type":"array","items":{"type":"string"}},"dropped_gates":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["skill_gate","metric_filter"]},"metric":{"type":"string"},"window":{"type":"string"},"reason":{"type":"string"}},"required":["kind","metric","window","reason"],"additionalProperties":false}},"effective_weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"grain":{"type":"string","enum":["wallet","user"]},"explain":{"type":"object","properties":{"cohort_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"gates":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"condition":{"type":"string"},"dropped":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["label","condition","dropped","remaining"],"additionalProperties":false}}},"required":["cohort_size","gates"],"additionalProperties":false}},"required":["rows","total_rows","cohort_size","normalized_weights","gated_out_count","query_ms","snapshot_age_seconds"],"additionalProperties":false}}}}},"operationId":"get-rankings-preset","summary":"GET /v1/rankings/preset/{slug}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/rankings/eval/{preset_id}":{"get":{"tags":["rankings"],"description":"Nightly forward-performance evaluation for a preset (or signal:): rank-vs-forward-PnL Spearman, top-decile forward-PnL lift, forward Brier, survivorship — latest-first. The evidence for choosing which ranking to trust.","parameters":[{"schema":{"default":30,"type":"integer","minimum":1,"maximum":180},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":80,"pattern":"^[a-z0-9:_-]+$"},"in":"path","name":"preset_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"preset_id":{"type":"string"},"runs":{"type":"array","items":{"type":"object","properties":{"run_at":{"type":"string"},"kind":{"type":"string"},"grain":{"type":"string"},"top_k":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cohort_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"intent_pass":{"type":"boolean"},"intent_score":{"type":"number"},"anti_flags":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"spearman":{"type":["number","null"]},"topk_lift_pnl":{"type":["number","null"]},"topk_fwd_brier":{"type":["number","null"]},"survivorship":{"type":["number","null"]},"snapshot_age_sec":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["run_at","kind","grain","top_k","cohort_size","intent_pass","intent_score","anti_flags","spearman","topk_lift_pnl","topk_fwd_brier","survivorship","snapshot_age_sec"],"additionalProperties":false}}},"required":["preset_id","runs"],"additionalProperties":false}}}}},"operationId":"get-rankings-eval","summary":"GET /v1/rankings/eval/{preset_id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/rankings/preset/{slug}/snapshot":{"get":{"tags":["rankings"],"description":"A preset's persisted top-K board for a given day (rank + key + composite). Stable and lookahead-free — the selection object for slow-loop consumers. Omit ?date for the latest snapshot.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"date","required":false},{"schema":{"default":100,"type":"integer","minimum":1,"maximum":500},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":64,"pattern":"^[a-z0-9-]+$"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"preset_id":{"type":"string"},"snapshot_date":{"type":["string","null"]},"grain":{"type":["string","null"]},"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"key":{"type":"string"},"composite_score":{"type":"number"}},"required":["rank","key","composite_score"],"additionalProperties":false}}},"required":["preset_id","snapshot_date","grain","rows"],"additionalProperties":false}}}}},"operationId":"get-rankings-preset-snapshot","summary":"GET /v1/rankings/preset/{slug}/snapshot","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/rankings/saved":{"get":{"tags":["rankings"],"description":"List the authenticated user's saved rankings.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rankings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"is_public":{"type":"boolean"},"public_slug":{"type":["string","null"]},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight","window"],"additionalProperties":false}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"required":["sleeve"],"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","window","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile","window"],"additionalProperties":false}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","window"],"additionalProperties":false}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["version","weights","filters","na_policy","preset_id","created_via_preset_id"],"additionalProperties":false},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","is_public","public_slug","config","created_at","updated_at"],"additionalProperties":false}},"skipped":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"reason":{"type":"string"}},"required":["id","name","reason"],"additionalProperties":false}}},"required":["rankings"],"additionalProperties":false}}}}},"operationId":"get-rankings-saved","summary":"GET /v1/rankings/saved","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["rankings"],"description":"Save a custom Builder ranking. Set is_public to publish it at a shareable public slug.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]},"name":{"type":"string","minLength":1,"maxLength":80},"is_public":{"default":false,"type":"boolean"}},"required":["weights","name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"is_public":{"type":"boolean"},"public_slug":{"type":["string","null"]},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight","window"],"additionalProperties":false}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"required":["sleeve"],"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","window","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile","window"],"additionalProperties":false}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","window"],"additionalProperties":false}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["version","weights","filters","na_policy","preset_id","created_via_preset_id"],"additionalProperties":false},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","is_public","public_slug","config","created_at","updated_at"],"additionalProperties":false}}}}},"operationId":"post-rankings-saved","summary":"POST /v1/rankings/saved","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/rankings/saved/{id}":{"get":{"tags":["rankings"],"description":"Fetch one saved ranking (owner only).","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"is_public":{"type":"boolean"},"public_slug":{"type":["string","null"]},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight","window"],"additionalProperties":false}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"required":["sleeve"],"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","window","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile","window"],"additionalProperties":false}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","window"],"additionalProperties":false}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["version","weights","filters","na_policy","preset_id","created_via_preset_id"],"additionalProperties":false},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","is_public","public_slug","config","created_at","updated_at"],"additionalProperties":false}}}}},"operationId":"get-rankings-saved-2","summary":"GET /v1/rankings/saved/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"patch":{"tags":["rankings"],"description":"Update a saved ranking (owner only): rename, re-configure, or (un)publish.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"is_public":{"type":"boolean"},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["weights"],"additionalProperties":false}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"is_public":{"type":"boolean"},"public_slug":{"type":["string","null"]},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight","window"],"additionalProperties":false}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"required":["sleeve"],"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","window","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile","window"],"additionalProperties":false}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","window"],"additionalProperties":false}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["version","weights","filters","na_policy","preset_id","created_via_preset_id"],"additionalProperties":false},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","is_public","public_slug","config","created_at","updated_at"],"additionalProperties":false}}}}},"operationId":"patch-rankings-saved","summary":"PATCH /v1/rankings/saved/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["rankings"],"description":"Delete a saved ranking (owner only).","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}}},"operationId":"delete-rankings-saved","summary":"DELETE /v1/rankings/saved/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/copy-engine/board":{"get":{"tags":["copy-engine"],"description":"The Copy Engine board: sleeve-eligible wallets for the latest published day, ranked by the forward-tested 14d skill score (sleeve A) or the 30d in-band copy return (sleeve B), with the four hard gates and a per-wallet copyability summary. Each row also carries sk_percentile (rank against the whole ~119k-wallet published universe), holding style, measured book depth, the validated depth-capped clip sizes, and `why` — 2-4 plain-English reasons built only from non-null fields. Cached 5 minutes; the underlying table publishes daily at 06:45 UTC.","parameters":[{"schema":{"default":"a","type":"string","enum":["a","b","any"]},"in":"query","name":"sleeve","required":false},{"schema":{"default":"sk_score_14d","type":"string","enum":["sk_score_14d","inband_return_30d","taker_inband_pnl_14d","signal_freshness_hours"]},"in":"query","name":"sort","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000},"in":"query","name":"offset","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"as_of","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"as_of_date":{"type":["string","null"]},"sleeve":{"type":"string","enum":["a","b","any"]},"sort":{"type":"string","enum":["sk_score_14d","inband_return_30d","taker_inband_pnl_14d","signal_freshness_hours"]},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"returned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rows_capped_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"proxy_wallet":{"type":"string"},"wallet_label":{"type":"string"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"sk_score_14d":{"type":["number","null"]},"sk_n_14d":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"inband_return_30d":{"type":["number","null"]},"inband_n_30d":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"inband_sd_30d":{"type":["number","null"]},"lifetime_pnl_usd":{"type":["number","null"]},"lifetime_edge_pp":{"type":["number","null"]},"lifetime_gate_pass":{"type":["boolean","null"]},"taker_inband_pnl_14d":{"type":"number"},"sniper_median_ttr_min":{"type":["number","null"]},"sniper_share":{"type":["number","null"]},"signal_freshness_hours":{"type":["number","null"]},"active_days_14d":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"luck_z":{"type":["number","null"]},"decay_switch_flag":{"type":"boolean"},"top_category":{"type":["string","null"]},"template_fingerprint":{"type":"string"},"sleeve_a_eligible":{"type":"boolean"},"sleeve_b_eligible":{"type":"boolean"},"copyability":{"type":"object","properties":{"verdict":{"type":"string","enum":["copyable","watch","blocked"]},"sniper_ok":{"type":"boolean"},"live_ok":{"type":"boolean"},"no_decay":{"type":"boolean"},"taker_visible":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["verdict","sniper_ok","live_ok","no_decay","taker_visible","reasons"],"additionalProperties":false},"sk_percentile":{"type":["number","null"]},"sk_rank_universe":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"sk_universe_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"median_hold_hours":{"type":["number","null"]},"in_play_share_90d":{"type":["number","null"]},"wallet_age_days":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"in_play_chip":{"type":"boolean"},"new_wallet_chip":{"type":"boolean"},"median_entry_depth_usd":{"type":["number","null"]},"depth_sample_n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"suggested_clip_usd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"max_clip_usd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"why":{"type":"array","items":{"type":"string"}}},"required":["rank","proxy_wallet","wallet_label","display","sk_score_14d","sk_n_14d","inband_return_30d","inband_n_30d","inband_sd_30d","taker_inband_pnl_14d","sniper_median_ttr_min","sniper_share","signal_freshness_hours","active_days_14d","luck_z","decay_switch_flag","top_category","template_fingerprint","sleeve_a_eligible","sleeve_b_eligible","copyability","sk_percentile","sk_rank_universe","sk_universe_n","median_hold_hours","in_play_share_90d","wallet_age_days","in_play_chip","new_wallet_chip","median_entry_depth_usd","depth_sample_n","suggested_clip_usd","max_clip_usd","why"],"additionalProperties":false}}},"required":["as_of_date","sleeve","sort","total","returned","rows_capped_at","snapshot_age_seconds","rows"],"additionalProperties":false}}}}},"operationId":"get-copy-engine-board","summary":"GET /v1/copy-engine/board","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/public/copy-engine/funnel":{"get":{"tags":["public"],"description":"The Copy Engine's per-gate funnel for the latest published day: how many wallets remain after each hard gate, cumulatively (scored → still trading → not sniping → copyable profit → not fading), then how many also clear sleeve A (positive 14d skill). Aggregate counts only. Cached 5 minutes.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"as_of_date":{"type":["string","null"]},"params_source":{"type":"string","enum":["run_journal","defaults"]},"steps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"remaining":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","remaining"],"additionalProperties":false}}},"required":["as_of_date","params_source","steps"],"additionalProperties":false}}}}},"operationId":"get-public-copy-engine-funnel","summary":"GET /v1/public/copy-engine/funnel"}},"/v1/copy-engine/methodology":{"get":{"tags":["copy-engine"],"description":"The Copy Engine configuration ACTUALLY in force for a published day, read from the run journal (poly.wallet_copy_engine_runs) — window lengths, shrinkage prior, price/cost band, gate thresholds and sleeve floors — plus the gate and metric definitions. params_source says whether the numbers are journaled or fallback defaults.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"as_of","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"as_of_date":{"type":["string","null"]},"rows_written":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"computed_at":{"type":["string","null"]},"params_source":{"type":"string","enum":["run_journal","defaults"]},"params":{"type":"object","properties":{"tau":{"type":"number"},"sk_window_days":{"type":"number"},"inband_window_days":{"type":"number"},"band_low":{"type":"number"},"band_high":{"type":"number"},"cost_min":{"type":"number"},"cost_max":{"type":"number"},"sniper_min_ttr_min":{"type":"number"},"liveness_max_hours":{"type":"number"},"min_sk_n_universe":{"type":"number"},"min_inband_n_universe":{"type":"number"},"min_sk_n_sleeve_a":{"type":"number"},"min_inband_n_sleeve_b":{"type":"number"},"decay_post_days":{"type":"number"},"decay_min_drop":{"type":"number"},"decay_t_max":{"type":"number"},"decay_min_half_n":{"type":"number"},"max_rows_per_day":{"type":"number"},"max_wcr_stale_hours":{"type":"number"}},"required":["tau","sk_window_days","inband_window_days","band_low","band_high","cost_min","cost_max","sniper_min_ttr_min","liveness_max_hours","min_sk_n_universe","min_inband_n_universe","min_sk_n_sleeve_a","min_inband_n_sleeve_b","decay_post_days","decay_min_drop","decay_t_max","decay_min_half_n","max_rows_per_day","max_wcr_stale_hours"],"additionalProperties":false},"sleeves":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["a","b"]},"name":{"type":"string"},"engine_metric":{"type":"string"},"sample_metric":{"type":"string"},"min_n":{"type":"number"},"description":{"type":"string"}},"required":["id","name","engine_metric","sample_metric","min_n","description"],"additionalProperties":false}},"gates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"metric":{"type":"string"},"threshold":{"type":"string"},"description":{"type":"string"},"in_force":{"type":["boolean","null"]}},"required":["id","label","metric","threshold","description","in_force"],"additionalProperties":false}},"metrics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"direction":{"type":"string"},"minN":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sampleSizeColumn":{"type":"string"}},"required":["id","name","description","category","direction","minN","sampleSizeColumn"],"additionalProperties":false}}},"required":["as_of_date","rows_written","computed_at","params_source","params","sleeves","gates","metrics"],"additionalProperties":false}}}}},"operationId":"get-copy-engine-methodology","summary":"GET /v1/copy-engine/methodology","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/metrics/catalog":{"get":{"tags":["metrics"],"description":"The full metric catalog (count is dynamic). Each entry has id, name, description, category, direction, cost, longTailed flag, minN, supportedWindows. Single source of truth.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"metrics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"direction":{"type":"string"},"cost":{"type":"string"},"cadence":{"type":"string","enum":["hourly","daily","weekly"]},"longTailed":{"type":"boolean"},"minN":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sampleSizeColumn":{"type":"string"},"supportedWindows":{"type":"array","items":{"type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"displayableWindows":{"type":"array","items":{"type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"defaultWindow":{"type":"string","enum":["lifetime","90d","30d","7d","24h"]},"compositeNeutralDefault":{"type":"boolean"},"advanced":{"type":"boolean"},"cluster":{"type":"string"}},"required":["id","name","description","category","direction","cost","cadence","longTailed","minN","sampleSizeColumn","supportedWindows","displayableWindows","defaultWindow","compositeNeutralDefault","advanced"],"additionalProperties":false}},"deprecated":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"since":{"type":"string"},"reason":{"type":"string"}},"required":["id","name","since","reason"],"additionalProperties":false}},"engine_metrics":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"direction":{"type":"string"},"cost":{"type":"string"},"cadence":{"type":"string","enum":["hourly","daily","weekly"]},"longTailed":{"type":"boolean"},"minN":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sampleSizeColumn":{"type":"string"},"defaultWindow":{"type":"string","enum":["lifetime","90d","30d","7d","24h"]},"compositeNeutralDefault":{"type":"boolean"},"advanced":{"type":"boolean"},"cluster":{"type":"string"},"source":{"type":"string","enum":["copy_engine_daily"]}},"required":["id","name","description","category","direction","cost","cadence","longTailed","minN","sampleSizeColumn","defaultWindow","compositeNeutralDefault","advanced","source"],"additionalProperties":false}}},"required":["version","count","metrics","deprecated","engine_metrics"],"additionalProperties":false}}}}},"operationId":"get-metrics-catalog","summary":"GET /v1/metrics/catalog","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/metrics/coverage":{"get":{"tags":["metrics"],"description":"Per-metric coverage: how many wallets the metric is RANKED for (a finite percentile), per window, over that window's percentile cohort. Not the raw finite count — a sentinel zero is finite and was inflating this by up to 1.9x. Cached 1 hour.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"cohort":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"byWindow":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"cohort":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["cohort","coverage"],"additionalProperties":false}}},"required":["cohort","coverage","byWindow"],"additionalProperties":false}}}}},"operationId":"get-metrics-coverage","summary":"GET /v1/metrics/coverage","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/metrics/distribution/{metric}":{"get":{"tags":["metrics"],"parameters":[{"schema":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]},"in":"query","name":"window","required":false},{"schema":{"type":"string"},"in":"path","name":"metric","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"metric":{"type":"string"},"window":{"type":"string","enum":["lifetime","90d","30d","7d","24h"]},"snapshot_date":{"type":"string"},"p1":{"type":"number"},"p5":{"type":"number"},"p10":{"type":"number"},"p25":{"type":"number"},"p50":{"type":"number"},"p75":{"type":"number"},"p90":{"type":"number"},"p95":{"type":"number"},"p99":{"type":"number"},"mean":{"type":"number"},"stdev":{"type":"number"},"n_wallets_eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["metric","window","snapshot_date","p1","p5","p10","p25","p50","p75","p90","p95","p99","mean","stdev","n_wallets_eligible"],"additionalProperties":false}}}}},"operationId":"get-metrics-distribution","summary":"GET /v1/metrics/distribution/{metric}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}":{"get":{"tags":["trader"],"description":"Trader profile — every metric value, every percentile rank, plus display enrichment. Full-metric depth is a paid feature; Free gets the public teaser (/v1/public/trader).","parameters":[{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"in":"query","name":"budget","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"metrics_lifetime":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"percentiles_lifetime":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"first_trade_at":{"type":["string","null"]},"last_trade_at":{"type":["string","null"]},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"x_username":{"type":["string","null"]},"verified":{"type":"boolean"},"bio":{"type":["string","null"]},"eoa":{"type":["string","null"]},"claimed":{"type":"boolean"},"claimed_by_me":{"type":"boolean"},"founding":{"type":"boolean"}},"required":["username","pseudonym","profile_image","x_username","verified","bio","eoa","claimed","claimed_by_me","founding"],"additionalProperties":false},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"valuation":{"type":"object","properties":{"status":{"type":"string","enum":["too_large","unavailable"]},"error":{"type":"string","enum":["wallet_too_large","wallet_state_unavailable"]},"reason":{"type":"string","enum":["too_large","timeout","memory"]},"agg_rows":{"type":["number","null"]},"limit":{"type":"number"},"retry_after":{"type":"number"}},"required":["status","error","reason","agg_rows","limit"],"additionalProperties":false},"freshness":{"type":"object","properties":{"fills":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"marks":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"metrics":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"as_of":{"type":["string","null"]}},"required":["fills","marks","metrics","as_of"],"additionalProperties":false},"metrics_windows":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"realized_pnl":{"type":["number","null"]},"volume_usdc":{"type":["number","null"]},"roi_pct":{"type":["number","null"]},"n_trades":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["realized_pnl","volume_usdc","roi_pct","n_trades"],"additionalProperties":false},{"type":"null"}]}},"predictor":{"type":"object","properties":{"status":{"type":"string","enum":["ok","unavailable"]},"reason":{"anyOf":[{"type":"string","enum":["convert_wallet","wallet_scope","not_built","no_row","read_failed"]},{"type":"null"}]},"prediction_accuracy_pct":{"type":["number","null"]},"prediction_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"mean_entry_price":{"type":["number","null"]},"n_right_call_lost":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"n_wrong_call_profited":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"win_rate_closed_pct":{"type":["number","null"]},"closed_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"n_sold_open":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"held_to_resolution_pct":{"type":["number","null"]},"held_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"luck_adjusted_edge_z":{"type":["number","null"]},"avg_win_usdc":{"type":["number","null"]},"avg_loss_usdc":{"type":["number","null"]},"biggest_win_usdc":{"type":["number","null"]},"biggest_win_condition_id":{"type":["string","null"]},"biggest_win_title":{"type":["string","null"]},"biggest_loss_usdc":{"type":["number","null"]},"biggest_loss_condition_id":{"type":["string","null"]},"biggest_loss_title":{"type":["string","null"]},"buy_fees_usdc":{"type":["number","null"]},"worst_realized_day_pnl_usdc":{"type":["number","null"]},"worst_realized_day":{"type":["string","null"]},"computed_at":{"type":["string","null"]}},"required":["status","reason","prediction_accuracy_pct","prediction_n","mean_entry_price","n_right_call_lost","n_wrong_call_profited","win_rate_closed_pct","closed_n","n_sold_open","held_to_resolution_pct","held_n","luck_adjusted_edge_z","avg_win_usdc","avg_loss_usdc","biggest_win_usdc","biggest_win_condition_id","biggest_win_title","biggest_loss_usdc","biggest_loss_condition_id","biggest_loss_title","buy_fees_usdc","worst_realized_day_pnl_usdc","worst_realized_day","computed_at"],"additionalProperties":false},"user_id":{"type":"string"},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scope":{"type":"string","enum":["combined","wallet"]},"wallets":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"realized_pnl":{"type":"number"},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"is_primary":{"type":"boolean"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false}},"required":["proxy_wallet","realized_pnl","lifetime_volume_usdc","trade_count","win_rate_pct","is_primary"],"additionalProperties":false}}},"required":["proxy_wallet","metrics_lifetime","percentiles_lifetime","first_trade_at","last_trade_at","trade_count","markets_traded","display","snapshot_age_seconds","freshness"],"additionalProperties":false}}}},"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader","summary":"GET /v1/trader/{proxy}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/trades":{"get":{"tags":["trader"],"description":"Paginated trade history. Cursor-based. Paid feature (metrics_full).","parameters":[{"schema":{"type":"string"},"in":"query","name":"cursor","required":false,"description":"Opaque cursor from previous response."},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"default":"both","type":"string","enum":["maker","taker","both"]},"in":"query","name":"side","required":false},{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"query","name":"since","required":false,"description":"unix ts (s or ms) or ISO-8601 lower bound."},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"block_time":{"type":"string"},"block_number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"condition_id":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"outcome_side":{"type":"string","enum":["YES","NO","NA"]},"is_buy":{"type":"boolean"},"side":{"type":"string","enum":["maker","taker"]},"price":{"type":"number"},"size_shares":{"type":"number"},"notional_usdc":{"type":"number"},"fee_paid":{"type":"number"},"status":{"anyOf":[{"type":"string","enum":["OPEN","CLOSED","WON","LOST","BREAKEVEN","REDEEMABLE"]},{"type":"null"}]},"exchange_version":{"type":"string"},"exchange_kind":{"type":"string"}},"required":["tx_hash","block_time","block_number","condition_id","market_title","market_slug","outcome_side","is_buy","side","price","size_shares","notional_usdc","fee_paid","status","exchange_version","exchange_kind"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"live_fills":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["off","record","on"]},"state":{"type":"string","enum":["fresh","refreshed","deferred","skipped","failed"]},"newest_indexed_at":{"type":["string","null"]},"newest_live_at":{"type":["string","null"]},"newer_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rows":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"ts":{"type":"string"},"condition_id":{"type":"string"},"token_id":{"type":"string"},"side":{"type":"string","enum":["BUY","SELL"]},"size_shares":{"type":"number"},"price":{"type":"number"},"notional_usdc":{"type":"number"},"market_title":{"type":["string","null"]},"outcome":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"source":{"type":"string","enum":["data_api_ondemand"]}},"required":["tx_hash","ts","condition_id","token_id","side","size_shares","price","notional_usdc","market_title","outcome","market_slug","source"],"additionalProperties":false}},"fetch_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false}},"required":["mode","state","newest_indexed_at","newest_live_at","newer_count","rows","fetch_ms","freshness"],"additionalProperties":false},{"type":"null"}]}},"required":["rows","next_cursor","has_more","live_fills"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-trades","summary":"GET /v1/trader/{proxy}/trades","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/positions":{"get":{"tags":["trader"],"description":"Open/closed positions for a trader. Paid feature (metrics_full).","parameters":[{"schema":{"default":"open","type":"string","enum":["open","closed","all"]},"in":"query","name":"status","required":false},{"schema":{"default":100,"type":"integer","minimum":1,"maximum":500},"in":"query","name":"limit","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":200000},"in":"query","name":"offset","required":false},{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"default":"value","type":"string","enum":["value","pnl","date"]},"in":"query","name":"sort","required":false},{"schema":{"type":"string","minLength":1,"maxLength":100},"in":"query","name":"q","required":false,"description":"Case-insensitive text search over the market title and the named outcome, applied before pagination (1-100 characters)."},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"outcome_token_id":{"type":"string"},"condition_id":{"type":"string"},"is_combo":{"type":"boolean"},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"outcome_side":{"type":"string","enum":["YES","NO","NA"]},"outcome_name":{"type":"string"},"shares_held":{"type":"number"},"avg_cost":{"type":"number"},"cost_basis":{"type":"number"},"current_mid":{"type":["number","null"]},"current_value":{"type":"number"},"realized_pnl":{"type":"number"},"unrealized_pnl":{"type":"number"},"total_pnl":{"type":"number"},"pct_return":{"type":["number","null"]},"buy_cost_usdc":{"type":"number"},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"status":{"type":"string","enum":["OPEN","CLOSED","WON","LOST","BREAKEVEN","REDEEMABLE"]},"redeemable":{"type":"boolean"},"resolved_at":{"type":["string","null"]},"last_activity_at":{"type":["string","null"]},"freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false}},"required":["outcome_token_id","condition_id","is_combo","market_title","market_slug","outcome_side","outcome_name","shares_held","avg_cost","cost_basis","current_mid","current_value","realized_pnl","unrealized_pnl","total_pnl","pct_return","buy_cost_usdc","resolved","winner_outcome","status","redeemable","resolved_at","last_activity_at","freshness"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"live_marks":{"type":"object","properties":{"mode":{"type":"string","enum":["off","record","on"]},"stale":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"refreshed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deferred":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fetch_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","stale","refreshed","deferred","fetch_ms"],"additionalProperties":false}},"required":["rows","total","live_marks"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-positions","summary":"GET /v1/trader/{proxy}/positions","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/activity":{"get":{"tags":["trader"],"description":"Unified activity feed — trades + settlements (redeems) + splits/merges/converts. Paid feature (metrics_full).","parameters":[{"schema":{"default":"all","type":"string","enum":["all","trade","settlement","other"]},"in":"query","name":"kind","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":200000},"in":"query","name":"offset","required":false},{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string"},"type":{"type":"string","enum":["BUY","SELL","REDEEM","Split","Merge","Convert"]},"condition_id":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"outcome_side":{"type":"string","enum":["YES","NO","NA"]},"price":{"type":["number","null"]},"shares":{"type":"number"},"usdc":{"type":"number"},"tx_hash":{"type":["string","null"]}},"required":["ts","type","condition_id","market_title","market_slug","outcome_side","price","shares","usdc","tx_hash"],"additionalProperties":false}},"has_more":{"type":"boolean"},"live_fills":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["off","record","on"]},"state":{"type":"string","enum":["fresh","refreshed","deferred","skipped","failed"]},"newest_indexed_at":{"type":["string","null"]},"newest_live_at":{"type":["string","null"]},"newer_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rows":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"ts":{"type":"string"},"condition_id":{"type":"string"},"token_id":{"type":"string"},"side":{"type":"string","enum":["BUY","SELL"]},"size_shares":{"type":"number"},"price":{"type":"number"},"notional_usdc":{"type":"number"},"market_title":{"type":["string","null"]},"outcome":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"source":{"type":"string","enum":["data_api_ondemand"]}},"required":["tx_hash","ts","condition_id","token_id","side","size_shares","price","notional_usdc","market_title","outcome","market_slug","source"],"additionalProperties":false}},"fetch_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false}},"required":["mode","state","newest_indexed_at","newest_live_at","newer_count","rows","fetch_ms","freshness"],"additionalProperties":false},{"type":"null"}]}},"required":["rows","has_more","live_fills"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-activity","summary":"GET /v1/trader/{proxy}/activity","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/copy-fitness":{"get":{"tags":["trader"],"description":"Copy-decision bundle (hold-time, entry price, taker share, clip distribution, traded-market liquidity, verdict) + budget-fit. Paid feature (metrics_full).","parameters":[{"schema":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":1000000},"in":"query","name":"budget","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response"}},"operationId":"get-trader-copy-fitness","summary":"GET /v1/trader/{proxy}/copy-fitness","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/calibration":{"get":{"tags":["trader"],"description":"Trader reliability diagram: 10 predicted-vs-observed bins.","parameters":[{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"bins":{"minItems":10,"maxItems":10,"type":"array","items":{"type":"object","properties":{"bin_idx":{"type":"integer","minimum":0,"maximum":9},"bin_label":{"type":"string"},"predicted_mean":{"type":"number"},"observed_rate":{"type":["number","null"]},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bin_idx","bin_label","predicted_mean","observed_rate","n"],"additionalProperties":false}},"n_total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["proxy_wallet","bins","n_total"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-calibration","summary":"GET /v1/trader/{proxy}/calibration","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/pnl_curve":{"get":{"tags":["trader"],"description":"Daily cumulative P&L from FIFO position lifecycle. Paid feature (metrics_full).","parameters":[{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"daily_pnl_usdc":{"type":"number"},"cum_pnl_usdc":{"type":"number"}},"required":["day","daily_pnl_usdc","cum_pnl_usdc"],"additionalProperties":false}},"realized_pnl_total":{"type":"number"},"rebasing":{"type":"boolean"}},"required":["proxy_wallet","points","realized_pnl_total","rebasing"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-pnlcurve","summary":"GET /v1/trader/{proxy}/pnl_curve","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/timing-skill":{"get":{"tags":["trader"],"description":"Category × entry-timing skill grid for a trader (CH 0146). Every cell carries its own n; cells below the window floor are returned but flagged not rankable.","parameters":[{"schema":{"default":"14d","type":"string","enum":["14d","90d"]},"in":"query","name":"window","required":false},{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"available":{"type":"boolean"},"window":{"type":"string","enum":["14d","90d"]},"as_of":{"type":["string","null"]},"min_n_rankable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maker_flow_threshold":{"type":"number"},"subs":{"type":"array","items":{"type":"string"}},"buckets":{"type":"array","items":{"type":"string"}},"cells":{"type":"array","items":{"type":"object","properties":{"sub":{"type":"string"},"bucket_group":{"type":"string"},"skill":{"type":"number"},"tau":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_taker":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_taker_scanned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"hit_rate_excess":{"type":"number"},"luck_z":{"type":["number","null"]},"early_entry_return":{"type":"number"},"mean_p_entry":{"type":"number"},"pnl_usd":{"type":"number"},"cost_usd":{"type":"number"},"last_entry_at":{"type":["string","null"]},"rankable":{"type":"boolean"},"maker_flow":{"type":["boolean","null"]}},"required":["sub","bucket_group","skill","tau","n","n_taker","n_taker_scanned","hit_rate_excess","luck_z","early_entry_return","mean_p_entry","pnl_usd","cost_usd","last_entry_at","rankable","maker_flow"],"additionalProperties":false}},"best":{"anyOf":[{"type":"object","properties":{"sub":{"type":"string"},"bucket_group":{"type":"string"},"skill":{"type":"number"},"tau":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_taker":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_taker_scanned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"hit_rate_excess":{"type":"number"},"luck_z":{"type":["number","null"]},"early_entry_return":{"type":"number"},"mean_p_entry":{"type":"number"},"pnl_usd":{"type":"number"},"cost_usd":{"type":"number"},"last_entry_at":{"type":["string","null"]},"rankable":{"type":"boolean"},"maker_flow":{"type":["boolean","null"]}},"required":["sub","bucket_group","skill","tau","n","n_taker","n_taker_scanned","hit_rate_excess","luck_z","early_entry_return","mean_p_entry","pnl_usd","cost_usd","last_entry_at","rankable","maker_flow"],"additionalProperties":false},{"type":"null"}]},"timing_profile":{"type":["string","null"]}},"required":["proxy_wallet","available","window","as_of","min_n_rankable","maker_flow_threshold","subs","buckets","cells","best","timing_profile"],"additionalProperties":false}}}}},"operationId":"get-trader-timing-skill","summary":"GET /v1/trader/{proxy}/timing-skill","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/return-distribution":{"get":{"tags":["trader"],"description":"Resolved-position return distribution over EVERY resolved position (P1-25). Buckets come from the shared RETURN_BUCKETS vocabulary; positions with a non-positive cost basis are reported separately rather than bucketed.","parameters":[{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"scope":{"type":"string","enum":["combined","wallet"]},"available":{"type":"boolean"},"n_positions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unscorable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"buckets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win":{"type":"boolean"}},"required":["id","name","count","win"],"additionalProperties":false}}},"required":["proxy_wallet","scope","available","n_positions","unscorable","buckets"],"additionalProperties":false}}}}},"operationId":"get-trader-return-distribution","summary":"GET /v1/trader/{proxy}/return-distribution","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/metrics":{"get":{"tags":["trader"],"description":"Every metric displayable at `window` for one trader: the raw value and its percentile in that window's cohort (the cells a Builder board at that window ranks on). scope=combined (default) reads the multi-wallet user row when the deployment ranks users.","parameters":[{"schema":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]},"in":"query","name":"window","required":false},{"schema":{"type":"string","enum":["combined","wallet"]},"in":"query","name":"scope","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"window":{"type":"string","enum":["lifetime","90d","30d","7d","24h"]},"grain":{"type":"string","enum":["wallet","user"]},"user_key":{"type":["string","null"]},"active_in_window":{"type":"boolean"},"n_trades":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"value":{"type":["number","null"]},"pctile":{"type":["number","null"]}},"required":["value","pctile"],"additionalProperties":false}}},"required":["proxy_wallet","window","grain","user_key","active_in_window","n_trades","metrics"],"additionalProperties":false}}}}},"operationId":"get-trader-metrics","summary":"GET /v1/trader/{proxy}/metrics","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/compare":{"get":{"tags":["compare"],"description":"Side-by-side comparison of 2-4 traders. Paid feature (Compare).","parameters":[{"schema":{"type":"string"},"in":"query","name":"addrs","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"traders":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"percentiles":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"rank_in_default_preset":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"first_trade_at":{"type":["string","null"]},"last_trade_at":{"type":["string","null"]},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["proxy_wallet","display","metrics","percentiles","rank_in_default_preset","first_trade_at","last_trade_at","trade_count","markets_traded"],"additionalProperties":false}},"winners":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","null"]}},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["traders","winners","snapshot_age_seconds"],"additionalProperties":false}}}},"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-compare","summary":"GET /v1/compare","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}":{"get":{"tags":["market"],"description":"Per-market summary: holder average entry (Brier-weighted average price current holders paid for YES — a cost basis, not a forecast), last-24h volume + positioning counts.","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"combo":{"anyOf":[{"type":"object","properties":{"n_legs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_resolved_legs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"yes_estimate":{"type":["number","null"]},"legs":{"type":"array","items":{"type":"object","properties":{"leg_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"market_condition_id":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"market_category":{"type":["string","null"]},"side_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"side_label":{"type":"string"},"status":{"type":"string","enum":["open","won","lost","partial","unknown"]},"price":{"type":["number","null"]}},"required":["leg_index","market_condition_id","market_title","market_slug","market_category","side_index","side_label","status","price"],"additionalProperties":false}}},"required":["n_legs","n_resolved_legs","yes_estimate","legs"],"additionalProperties":false},{"type":"null"}]},"market_title":{"type":["string","null"]},"market_category":{"type":["string","null"]},"market_subcategory":{"description":"Sub-category id inside `market_category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"market_subcategory_label":{"description":"Display label of `market_subcategory`.","type":["string","null"]},"market_subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"market_subtype_label":{"description":"Display label of `market_subtype`.","type":["string","null"]},"market_slug":{"type":["string","null"]},"event_slug":{"type":["string","null"]},"event_title":{"type":["string","null"]},"close_time":{"type":["string","null"]},"game_start_time":{"type":["string","null"]},"listed_at":{"type":["string","null"]},"end_date":{"type":["string","null"]},"event":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"slug":{"type":["string","null"]},"title":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"series_title":{"type":["string","null"]},"series_slug":{"type":["string","null"]},"series_recurrence":{"type":["string","null"]},"sport_code":{"type":["string","null"]},"sport_name":{"type":["string","null"]},"sport_discipline":{"type":["string","null"]},"team_names":{"type":"array","items":{"type":"string"}},"market_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"game_id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"live":{"type":["boolean","null"]},"ended":{"type":["boolean","null"]},"score":{"type":["string","null"]},"period":{"type":["string","null"]}},"required":["id","slug","title","category","subcategory","series_title","series_slug","series_recurrence","sport_code","sport_name","sport_discipline","team_names","market_count","game_id","live","ended","score","period"],"additionalProperties":false},{"type":"null"}]},"market_meta":{"anyOf":[{"type":"object","properties":{"sports_market_type":{"type":["string","null"]},"group_item_title":{"type":["string","null"]},"neg_risk":{"type":"boolean"},"neg_risk_market_id":{"type":["string","null"]},"resolution_source":{"type":["string","null"]},"fee_type":{"type":["string","null"]},"fee_rate":{"type":["number","null"]},"fee_rebate_rate":{"type":["number","null"]},"fee_taker_only":{"type":["boolean","null"]},"uma_bond":{"type":["number","null"]},"uma_reward":{"type":["number","null"]},"custom_liveness":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"uma_resolution_status":{"type":["string","null"]},"resolved_by":{"type":["string","null"]},"line":{"type":["number","null"]}},"required":["sports_market_type","group_item_title","neg_risk","neg_risk_market_id","resolution_source","fee_type","fee_rate","fee_rebate_rate","fee_taker_only","uma_bond","uma_reward","custom_liveness","uma_resolution_status","resolved_by","line"],"additionalProperties":false},{"type":"null"}]},"dates":{"type":"object","properties":{"listed":{"description":"Gamma market `createdAt`: when the market was created on Polymarket.","type":["string","null"]},"trading_opens":{"description":"Gamma market `acceptingOrdersTimestamp`: when the order book opened.","type":["string","null"]},"first_trade":{"description":"Ours: the first fill indexed for this market (poly.fills_dedup).","type":["string","null"]},"last_trade":{"description":"Ours: the latest fill indexed for this market (poly.fills_dedup).","type":["string","null"]},"event_start":{"description":"Gamma event `startTime` (else the market `eventStartTime`). A kick-off on sports events; on other events Gamma sets it at or near the listing, so it is NOT a scheduled real-world start there.","type":["string","null"]},"game_start":{"description":"Gamma market `gameStartTime`: the kick-off, on sports markets only.","type":["string","null"]},"scheduled_close":{"description":"Gamma market `endDate`: the date the question becomes eligible for resolution. NOT the end of trading: a market keeps trading past it until it is resolved, so it can be in the past on a live market (on sports it is usually the kick-off).","type":["string","null"]},"actual_close":{"description":"Gamma market `closedTime`: when Polymarket closed the market. Known only after the fact; null while the market is open.","type":["string","null"]},"resolved":{"description":"When the market resolved (poly.markets.resolution_time); null until then.","type":["string","null"]}},"required":["listed","trading_opens","first_trade","last_trade","event_start","game_start","scheduled_close","actual_close","resolved"],"additionalProperties":false},"resolved":{"type":"boolean"},"market_state":{"type":"string","enum":["LIVE","RESOLVING","RESOLVED","DORMANT"]},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"current_mid":{"type":["number","null"]},"mid_age_seconds":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"best_bid":{"type":["number","null"]},"best_ask":{"type":["number","null"]},"final_pre_resolution_mid":{"type":["number","null"]},"last_24h_volume_usdc":{"type":"number"},"last_24h_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"positioner_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Distinct TAKER wallets that filled in this market in the last 24 hours (poly.fills_dedup). Wallets that only provided liquidity (makers) are not counted; not a holder count."},"smart_money_positioner_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The subset of positioner_count (last-24-hour takers) carrying a whale, sharp, early_bird or contrarian tag."},"consensus_latest":{"anyOf":[{"type":"object","properties":{"ts":{"type":"string"},"polyrank_consensus_yes":{"type":"number"},"market_mid":{"type":"number"},"volume_weighted_yes":{"type":["number","null"]},"top10_smart_money_yes":{"type":["number","null"]},"n_positioners":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Holder POSITIONS (wallet x outcome token, so a wallet holding both sides counts twice) with held > 0 in the position snapshot (poly.wallet_open_positions, published once a day) when the row was computed; Polymarket contracts excluded. Current holders however they got the tokens (fills, splits, transfers); not a count of traders."}},"required":["ts","polyrank_consensus_yes","market_mid","volume_weighted_yes","top10_smart_money_yes","n_positioners"],"additionalProperties":false},{"type":"null"}]},"holder_entry_status":{"type":"object","properties":{"state":{"type":"string","enum":["ok","settled","combo","no_trades_24h","awaiting_holder_snapshot","awaiting_build"]},"positioned":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"min_positioned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"built_at":{"type":["string","null"]},"build_interval_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_build_at":{"type":["string","null"]}},"required":["state","positioned","min_positioned","built_at","build_interval_seconds","next_build_at"],"additionalProperties":false},"consensus_24h":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string"},"polyrank_consensus_yes":{"type":"number"},"market_mid":{"type":"number"},"volume_weighted_yes":{"type":["number","null"]},"top10_smart_money_yes":{"type":["number","null"]},"n_positioners":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Holder POSITIONS (wallet x outcome token, so a wallet holding both sides counts twice) with held > 0 in the position snapshot (poly.wallet_open_positions, published once a day) when the row was computed; Polymarket contracts excluded. Current holders however they got the tokens (fills, splits, transfers); not a count of traders."}},"required":["ts","polyrank_consensus_yes","market_mid","volume_weighted_yes","top10_smart_money_yes","n_positioners"],"additionalProperties":false}},"flow_24h":{"type":"array","items":{"type":"object","properties":{"bucket_ts":{"type":"string"},"total_volume_usdc":{"type":"number"},"yes_buy_volume_usdc":{"type":"number"},"no_buy_volume_usdc":{"type":"number"},"fills_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket_ts","total_volume_usdc","yes_buy_volume_usdc","no_buy_volume_usdc","fills_count"],"additionalProperties":false}},"mid_history_24h":{"type":"array","items":{"type":"object","properties":{"bucket_ts":{"type":"string"},"mid":{"type":"number"}},"required":["bucket_ts","mid"],"additionalProperties":false}},"siblings":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"title":{"type":"string"},"current_mid":{"description":"The YES mid, or null when there is no price: no mid on the tape, or a mid that is the midpoint of an empty, one-sided or stub book (best bid 0 or missing, best ask 1 or missing, or a spread of 0.9 or more).","type":["number","null"]},"quoted":{"type":"boolean","description":"current_mid is a two-sided quote; false exactly when current_mid is null."},"resolved":{"type":"boolean"},"group":{"type":"string"},"label":{"type":["string","null"]},"has_traded":{"type":"boolean"}},"required":["condition_id","title","current_mid","quoted","resolved","group","label","has_traded"],"additionalProperties":false}},"siblings_total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"skill_analytics_enabled":{"type":"boolean"},"liquidity":{"anyOf":[{"type":"object","properties":{"best_bid":{"type":"number"},"best_ask":{"type":"number"},"mid":{"type":"number"},"spread":{"type":"number"},"spread_pct":{"type":"number"},"bid_size":{"type":"number"},"ask_size":{"type":"number"},"bid_value_usd":{"type":"number"},"ask_value_usd":{"type":"number"},"bid_depth_usd":{"type":"number"},"ask_depth_usd":{"type":"number"},"book_imbalance":{"type":["number","null"]},"depth_band_cents":{"type":"number"}},"required":["best_bid","best_ask","mid","spread","spread_pct","bid_size","ask_size","bid_value_usd","ask_value_usd","bid_depth_usd","ask_depth_usd","book_imbalance","depth_band_cents"],"additionalProperties":false},{"type":"null"}]},"book_depth_enabled":{"type":"boolean"},"marks_as_of":{"type":["string","null"]},"book_stale":{"type":"boolean"},"min_order_size":{"type":["number","null"]},"min_tick_size":{"type":["number","null"]},"yes_token_id":{"type":["string","null"]},"mid_as_of":{"type":["string","null"]},"outcome_names":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"freshness":{"type":"object","properties":{"mid":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"book":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"resolution":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"as_of":{"type":["string","null"]}},"required":["mid","book","resolution","as_of"],"additionalProperties":false},"live":{"type":"object","properties":{"mode":{"type":"string","enum":["off","record","on"]},"checks":{"type":"object","properties":{"mid":{"type":"string","enum":["fresh","refreshed","deferred","skipped","failed"]},"book":{"type":"string","enum":["fresh","refreshed","deferred","skipped","failed"]},"resolution":{"type":"string","enum":["fresh","refreshed","deferred","skipped","failed"]}},"required":["mid","book","resolution"],"additionalProperties":false},"fetch_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","checks","fetch_ms"],"additionalProperties":false},"live_resolution":{"anyOf":[{"type":"object","properties":{"closed":{"type":"boolean"},"accepting_orders":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO"]},{"type":"null"}]},"checked_at":{"type":"string"},"ahead_of_oracle":{"type":"boolean"}},"required":["closed","accepting_orders","winner_outcome","checked_at","ahead_of_oracle"],"additionalProperties":false},{"type":"null"}]}},"required":["condition_id","combo","market_title","market_category","market_subcategory","market_subcategory_label","market_subtype","market_subtype_label","market_slug","event_slug","event_title","close_time","game_start_time","listed_at","end_date","event","market_meta","dates","resolved","market_state","winner_outcome","current_mid","mid_age_seconds","best_bid","best_ask","final_pre_resolution_mid","last_24h_volume_usdc","last_24h_fills","positioner_count","smart_money_positioner_count","consensus_latest","holder_entry_status","consensus_24h","flow_24h","mid_history_24h","siblings","siblings_total","skill_analytics_enabled","liquidity","book_depth_enabled","marks_as_of","book_stale","min_order_size","min_tick_size","yes_token_id","mid_as_of","outcome_names","freshness","live","live_resolution"],"additionalProperties":false}}}}},"operationId":"get-market","summary":"GET /v1/market/{conditionId}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/holders":{"get":{"tags":["market"],"description":"Top current holders of a market (canonical avg-cost lineage) with live value + P&L.","parameters":[{"schema":{"default":25,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"outcome_side":{"type":"string","enum":["YES","NO"]},"shares_held":{"type":"number"},"avg_cost":{"type":"number"},"has_mid":{"type":"boolean"},"current_value":{"type":["number","null"]},"unrealized_pnl":{"type":["number","null"]}},"required":["proxy_wallet","display_name","outcome_side","shares_held","avg_cost","has_mid","current_value","unrealized_pnl"],"additionalProperties":false}},"positions_as_of":{"type":["string","null"]}},"required":["condition_id","rows","positions_as_of"],"additionalProperties":false}}}}},"operationId":"get-market-holders","summary":"GET /v1/market/{conditionId}/holders","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/flow":{"get":{"tags":["market"],"description":"5-min flow buckets for the trailing window (max 168h = 7d).","parameters":[{"schema":{"default":24,"type":"integer","minimum":1,"maximum":168},"in":"query","name":"hours","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"buckets":{"type":"array","items":{"type":"object","properties":{"bucket_ts":{"type":"string"},"total_volume_usdc":{"type":"number"},"yes_buy_volume_usdc":{"type":"number"},"no_buy_volume_usdc":{"type":"number"},"fills_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket_ts","total_volume_usdc","yes_buy_volume_usdc","no_buy_volume_usdc","fills_count"],"additionalProperties":false}},"window_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["condition_id","buckets","window_hours"],"additionalProperties":false}}}}},"operationId":"get-market-flow","summary":"GET /v1/market/{conditionId}/flow","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/prices":{"get":{"tags":["market"],"description":"The YES token's price history for one window: the freshest order-book mid per bucket (15 m for 1d, 1 h for 1w, 4 h for 1m, 1 d for all), at most 500 points. On 1d / 1w / 1m the most recent are kept and `truncated` says so. window=all also draws from fills every UTC day the book tape has NO point for, before the tape begins or in a hole of it (one point per such day with a fill, share-weighted Yes-equivalent price; a day with a book point keeps the book point; a day with neither has no point, nothing is interpolated), stops at the market's close, and coarsens to weekly then monthly buckets instead of dropping the early part (a coarse bucket with any book day is a book point, one with trade days only is a trades point).","parameters":[{"schema":{"default":"1w","type":"string","enum":["1d","1w","1m","all"]},"in":"query","name":"window","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"window":{"type":"string","enum":["1d","1w","1m","all"]},"bucket_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"t":{"type":"string"},"mid":{"type":"number","description":"The Yes price, 0–1: the order-book mid when `source` is 'book', the share-weighted average Yes-equivalent fill price of the bucket when it is 'trades'."},"source":{"type":"string","enum":["trades","book"],"description":"'book' = the order-book mid tape; 'trades' = fills, drawn only on window=all, for a bucket the book tape has no point in: the days before the tape begins, and any later day (or coarsened week / month) the tape missed while the market traded."}},"required":["t","mid","source"],"additionalProperties":false}},"truncated":{"type":"boolean"},"bucket":{"description":"window=all only. The grain of EVERY point of the line (both sources): day, or week (Monday, UTC) then calendar month when the daily line would exceed 500 points. `bucket_seconds` is 86400 / 604800 / 2592000 (nominal for a month).","type":"string","enum":["day","week","month"]},"trades_until":{"description":"window=all only. The UTC day (YYYY-MM-DD) of the first order-book point, when points with source 'trades' precede it. null when no trade point is drawn before the first book point, or the market has no book tape and the whole line is trades. It marks where the book tape begins, not where trade points end: a later bucket the tape missed is a 'trades' point too (read `points[].source`).","type":["string","null"]},"first_point_at":{"description":"window=all only. `t` of the first served point; null when there is none.","type":["string","null"]}},"required":["condition_id","window","bucket_seconds","points","truncated"],"additionalProperties":false}}}}},"operationId":"get-market-prices","summary":"GET /v1/market/{conditionId}/prices","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/public/market/{conditionId}/prices":{"get":{"tags":["public"],"description":"The YES token's price history for one window: the freshest order-book mid per bucket (15 m for 1d, 1 h for 1w, 4 h for 1m, 1 d for all), at most 500 points. On 1d / 1w / 1m the most recent are kept and `truncated` says so. window=all also draws from fills every UTC day the book tape has NO point for, before the tape begins or in a hole of it (one point per such day with a fill, share-weighted Yes-equivalent price; a day with a book point keeps the book point; a day with neither has no point, nothing is interpolated), stops at the market's close, and coarsens to weekly then monthly buckets instead of dropping the early part (a coarse bucket with any book day is a book point, one with trade days only is a trades point).","parameters":[{"schema":{"default":"1w","type":"string","enum":["1d","1w","1m","all"]},"in":"query","name":"window","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"window":{"type":"string","enum":["1d","1w","1m","all"]},"bucket_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"points":{"type":"array","items":{"type":"object","properties":{"t":{"type":"string"},"mid":{"type":"number","description":"The Yes price, 0–1: the order-book mid when `source` is 'book', the share-weighted average Yes-equivalent fill price of the bucket when it is 'trades'."},"source":{"type":"string","enum":["trades","book"],"description":"'book' = the order-book mid tape; 'trades' = fills, drawn only on window=all, for a bucket the book tape has no point in: the days before the tape begins, and any later day (or coarsened week / month) the tape missed while the market traded."}},"required":["t","mid","source"],"additionalProperties":false}},"truncated":{"type":"boolean"},"bucket":{"description":"window=all only. The grain of EVERY point of the line (both sources): day, or week (Monday, UTC) then calendar month when the daily line would exceed 500 points. `bucket_seconds` is 86400 / 604800 / 2592000 (nominal for a month).","type":"string","enum":["day","week","month"]},"trades_until":{"description":"window=all only. The UTC day (YYYY-MM-DD) of the first order-book point, when points with source 'trades' precede it. null when no trade point is drawn before the first book point, or the market has no book tape and the whole line is trades. It marks where the book tape begins, not where trade points end: a later bucket the tape missed is a 'trades' point too (read `points[].source`).","type":["string","null"]},"first_point_at":{"description":"window=all only. `t` of the first served point; null when there is none.","type":["string","null"]}},"required":["condition_id","window","bucket_seconds","points","truncated"],"additionalProperties":false}}}}},"operationId":"get-public-market-prices","summary":"GET /v1/public/market/{conditionId}/prices"}},"/v1/market/{conditionId}/liquidity-history":{"get":{"tags":["market"],"description":"Liquidity depth over time: daily rollup (poly.liquidity_daily) or 15-min intraday buckets of the YES token depth. Forward-growing coverage (0087).","parameters":[{"schema":{"default":"daily","type":"string","enum":["daily","intraday"]},"in":"query","name":"granularity","required":false},{"schema":{"default":30,"type":"integer","minimum":1,"maximum":90},"in":"query","name":"days","required":false},{"schema":{"default":48,"type":"integer","minimum":1,"maximum":168},"in":"query","name":"hours","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"granularity":{"type":"string","enum":["daily","intraday"]},"yes_token_id":{"type":["string","null"]},"daily":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"depth_3c_usd":{"type":"number"},"mid":{"type":"number"},"spread":{"type":"number"},"tier":{"type":"string","enum":["thin","med","deep"]},"dollar_volume":{"type":"number"},"holders":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["day","depth_3c_usd","mid","spread","tier","dollar_volume","holders"],"additionalProperties":false}},"intraday":{"type":"array","items":{"type":"object","properties":{"bucket_ts":{"type":"string"},"mid":{"type":"number"},"bid":{"type":"number"},"ask":{"type":"number"},"bid_depth_3c_usd":{"type":"number"},"ask_depth_3c_usd":{"type":"number"}},"required":["bucket_ts","mid","bid","ask","bid_depth_3c_usd","ask_depth_3c_usd"],"additionalProperties":false}}},"required":["condition_id","granularity","yes_token_id","daily","intraday"],"additionalProperties":false}}}}},"operationId":"get-market-liquidity-history","summary":"GET /v1/market/{conditionId}/liquidity-history","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/flow/cohort":{"get":{"tags":["market"],"description":"Tagged-wallet flow: net YES-equivalent exposure flow split by Polyrank track-record tag (whale/sharp/early_bird/contrarian) vs untagged wallets, in 5-min buckets. Tag membership is mostly size- and behaviour-based, not forecasting-based.","parameters":[{"schema":{"default":24,"type":"integer","minimum":1,"maximum":72},"in":"query","name":"hours","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"window_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"buckets":{"type":"array","items":{"type":"object","properties":{"bucket_ts":{"type":"string"},"smart_net_yes_usdc":{"type":"number"},"crowd_net_yes_usdc":{"type":"number"},"smart_buy_usdc":{"type":"number"},"smart_sell_usdc":{"type":"number"},"crowd_buy_usdc":{"type":"number"},"crowd_sell_usdc":{"type":"number"},"smart_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"crowd_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bucket_ts","smart_net_yes_usdc","crowd_net_yes_usdc","smart_buy_usdc","smart_sell_usdc","crowd_buy_usdc","crowd_sell_usdc","smart_fills","crowd_fills"],"additionalProperties":false}},"headline":{"type":"object","properties":{"smart_net_yes_usdc":{"type":"number"},"crowd_net_yes_usdc":{"type":"number"},"smart_gross_usdc":{"type":"number"},"crowd_gross_usdc":{"type":"number"},"smart_wallets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"crowd_wallets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"smart_buy_yes_share":{"type":["number","null"]},"smart_lean":{"type":"string","enum":["YES","NO","BALANCED"]},"diverges":{"type":"boolean"}},"required":["smart_net_yes_usdc","crowd_net_yes_usdc","smart_gross_usdc","crowd_gross_usdc","smart_wallets","crowd_wallets","smart_buy_yes_share","smart_lean","diverges"],"additionalProperties":false},"as_of":{"type":["string","null"]}},"required":["condition_id","window_hours","buckets","headline","as_of"],"additionalProperties":false}}}}},"operationId":"get-market-flow-cohort","summary":"GET /v1/market/{conditionId}/flow/cohort","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/concentration":{"get":{"tags":["market"],"description":"Holder concentration: top-1/5/10 share + HHI per side, plus tagged-wallet share of open interest.","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"sides":{"type":"array","items":{"type":"object","properties":{"side":{"type":"string","enum":["YES","NO"]},"n_holders":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_shares":{"type":"number"},"top1_share":{"type":"number"},"top5_share":{"type":"number"},"top10_share":{"type":"number"},"hhi":{"type":"number"},"smart_share":{"type":"number"}},"required":["side","n_holders","total_shares","top1_share","top5_share","top10_share","hhi","smart_share"],"additionalProperties":false}},"as_of":{"type":["string","null"]}},"required":["condition_id","sides","as_of"],"additionalProperties":false}}}}},"operationId":"get-market-concentration","summary":"GET /v1/market/{conditionId}/concentration","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/resolution-risk":{"get":{"tags":["market"],"description":"Dispute-risk score (Low/Elevated/High + reasons) + live UMA settlement state.","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"level":{"type":"string","enum":["low","elevated","high"]},"score":{"type":"number"},"reasons":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"ever_disputed":{"type":"boolean"},"dispute_events":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"adapter":{"anyOf":[{"type":"string","enum":["v2","v3"]},{"type":"null"}]},"settlement":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["none","proposed","expired","disputed","settled","dvm"]},"proposed_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","TIE"]},{"type":"null"}]},"proposer":{"type":["string","null"]},"disputer":{"type":["string","null"]},"bond_usdc":{"type":["number","null"]},"liveness_ends":{"type":["string","null"]},"settleable":{"type":"boolean"},"in_dvm":{"type":"boolean"},"polled_at":{"type":["string","null"]}},"required":["state","proposed_outcome","proposer","disputer","bond_usdc","liveness_ends","settleable","in_dvm","polled_at"],"additionalProperties":false},{"type":"null"}]}},"required":["condition_id","level","score","reasons","version","ever_disputed","dispute_events","adapter","settlement"],"additionalProperties":false}}}}},"operationId":"get-market-resolution-risk","summary":"GET /v1/market/{conditionId}/resolution-risk","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/fills":{"get":{"tags":["market"],"description":"Recent fills for a market (cursor-paginated, descending block_time).","parameters":[{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"block_time":{"type":"string"},"block_number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"taker_proxy":{"type":"string"},"maker_proxy":{"type":"string"},"outcome_side":{"type":"string","enum":["YES","NO"]},"price":{"type":"number"},"size_shares":{"type":"number"},"notional_usdc":{"type":"number"},"exchange_version":{"type":"string"}},"required":["tx_hash","block_time","block_number","taker_proxy","maker_proxy","outcome_side","price","size_shares","notional_usdc","exchange_version"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["condition_id","rows","next_cursor"],"additionalProperties":false}}}}},"operationId":"get-market-fills","summary":"GET /v1/market/{conditionId}/fills","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/stats":{"get":{"tags":["market"],"description":"All-time market stats: volume, traders, YES/NO split, lifespan, top traders.","parameters":[{"schema":{"default":10,"type":"integer","minimum":1,"maximum":50},"in":"query","name":"top","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"total_volume_usdc":{"type":"number"},"total_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_traders":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Distinct TAKER wallets over the whole life of the market (poly.fills_dedup). Makers are NOT counted, so this is below the maker-inclusive recap n_traders; wallets that only split, merged or redeemed are in neither."},"avg_trade_size_usdc":{"type":"number"},"yes_volume_usdc":{"type":"number"},"no_volume_usdc":{"type":"number"},"yes_shares_held":{"type":"number","description":"YES shares held across all wallets, Polymarket protocol contracts excluded. SHARES, not dollars."},"no_shares_held":{"type":"number","description":"NO shares held across all wallets, Polymarket protocol contracts excluded. SHARES, not dollars."},"shares_held_total":{"type":"number","description":"yes_shares_held + no_shares_held."},"shares_held_basis":{"type":"string","enum":["current","at_resolution"],"description":"'current' on an open market. 'at_resolution' on a resolved one: the holder source is shares bought minus shares sold and redemptions are not subtracted, so the three shares_held fields are what was held when the market resolved, not what is still held."},"open_interest_usd":{"description":"Collateral locked in the market in dollars: $1 per YES/NO pair, so it equals yes_shares_held while the market is open. Null once the market is resolved (the losing side is worth nothing and redemptions are not in the holder source).","type":["number","null"]},"open_interest_shares":{"type":"number","description":"DEPRECATED, equal to yes_shares_held. Not a dollar amount on a resolved market."},"first_trade_time":{"type":["string","null"]},"last_trade_time":{"type":["string","null"]},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"resolution_time":{"type":["string","null"]},"time_to_resolution_hours":{"type":["number","null"]},"top_traders":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"volume_usdc":{"type":"number"},"fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["proxy_wallet","display_name","volume_usdc","fills"],"additionalProperties":false}}},"required":["condition_id","total_volume_usdc","total_fills","unique_traders","avg_trade_size_usdc","yes_volume_usdc","no_volume_usdc","yes_shares_held","no_shares_held","shares_held_total","shares_held_basis","open_interest_usd","open_interest_shares","first_trade_time","last_trade_time","resolved","winner_outcome","resolution_time","time_to_resolution_hours","top_traders"],"additionalProperties":false}}}}},"operationId":"get-market-stats","summary":"GET /v1/market/{conditionId}/stats","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/recap":{"get":{"tags":["market"],"description":"Resolution recap: outcome, settlement provenance, who-called-it-early, winners/losers, tagged-wallet hit-rate.","parameters":[{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"resolved_time":{"type":["string","null"]},"oracle":{"type":["string","null"]},"oracle_label":{"type":"string"},"source":{"type":"string"},"resolution_tx":{"type":["string","null"]},"final_pre_resolution_mid":{"type":["number","null"]},"total_won":{"type":"number"},"total_lost":{"type":"number"},"n_traders":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Distinct wallets with at least one fill on either outcome token over the whole life of the market, makers AND takers (poly.wallet_fills, one row per order owner). No contract exclusion; wallets that only split, merged or redeemed are not counted."},"top_winners":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"realized_pnl":{"type":"number"},"shares_won":{"type":"number"},"entry_price":{"type":["number","null"]},"first_entry_time":{"type":["string","null"]},"smart_money_tags":{"type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian"]}},"brier":{"type":["number","null"]}},"required":["proxy_wallet","display_name","realized_pnl","shares_won","entry_price","first_entry_time","smart_money_tags","brier"],"additionalProperties":false}},"top_losers":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"realized_pnl":{"type":"number"},"shares_won":{"type":"number"},"entry_price":{"type":["number","null"]},"first_entry_time":{"type":["string","null"]},"smart_money_tags":{"type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian"]}},"brier":{"type":["number","null"]}},"required":["proxy_wallet","display_name","realized_pnl","shares_won","entry_price","first_entry_time","smart_money_tags","brier"],"additionalProperties":false}},"early_callers":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"realized_pnl":{"type":"number"},"shares_won":{"type":"number"},"entry_price":{"type":["number","null"]},"first_entry_time":{"type":["string","null"]},"smart_money_tags":{"type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian"]}},"brier":{"type":["number","null"]}},"required":["proxy_wallet","display_name","realized_pnl","shares_won","entry_price","first_entry_time","smart_money_tags","brier"],"additionalProperties":false}},"smart_money":{"type":"object","properties":{"n_held":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_winning_side":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"hit_rate":{"type":["number","null"]}},"required":["n_held","n_winning_side","hit_rate"],"additionalProperties":false}},"required":["condition_id","resolved","winner_outcome","resolved_time","oracle","oracle_label","source","resolution_tx","final_pre_resolution_mid","total_won","total_lost","n_traders","top_winners","top_losers","early_callers","smart_money"],"additionalProperties":false}}}}},"operationId":"get-market-recap","summary":"GET /v1/market/{conditionId}/recap","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/event/{slug}":{"get":{"tags":["market"],"description":"Event (fixture) view: header, dates, every question in the fixture with our own 24h volume and live mids. Scoped to the whole game when Gamma provides a gameId.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":160},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"canonical_slug":{"type":"string"},"event_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"description":{"description":"Gamma's description of the event: its resolution rules, as plain text. Paragraphs are separated by newlines; URLs are bare text and nothing in it is markup, so render it as text (never as HTML or Markdown). Control characters are removed and it is cut at 10000 characters with a trailing ellipsis. Null when Gamma has none or it is not stored yet.","type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Gamma's own tag for the event (a sport name, or its first tag label): free text, not our registry. Ours is `market_subcategory`.","type":["string","null"]},"market_subcategory":{"description":"Sub-category id inside `market_category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"market_subcategory_label":{"description":"Display label of `market_subcategory`.","type":["string","null"]},"market_subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"market_subtype_label":{"description":"Display label of `market_subtype`.","type":["string","null"]},"series_title":{"type":["string","null"]},"series_slug":{"type":["string","null"]},"series_recurrence":{"type":["string","null"]},"sport_code":{"type":["string","null"]},"sport_name":{"type":["string","null"]},"sport_discipline":{"type":["string","null"]},"team_names":{"type":"array","items":{"type":"string"}},"team_abbrs":{"type":"array","items":{"type":"string"}},"game_id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"live":{"type":["boolean","null"]},"ended":{"type":["boolean","null"]},"score":{"type":"string"},"period":{"type":"string"},"resolution_source":{"type":"string"},"neg_risk":{"type":"boolean"},"fee":{"anyOf":[{"type":"object","properties":{"fee_type":{"type":["string","null"]},"fee_rate":{"type":["number","null"]},"fee_rebate_rate":{"type":["number","null"]},"fee_taker_only":{"type":["boolean","null"]}},"required":["fee_type","fee_rate","fee_rebate_rate","fee_taker_only"],"additionalProperties":false},{"type":"null"}],"description":"The fee schedule every question of the event shares. Null unless `fee_uniform` is true."},"fee_uniform":{"description":"True when every question carries the same fee schedule (then `fee` is it), false when they differ (read `questions[].fee`), null when it is not known for at least one question or the event has no question.","type":["boolean","null"]},"oracle":{"anyOf":[{"type":"object","properties":{"resolved_by":{"type":["string","null"]},"resolved_by_name":{"description":"A human name for `resolved_by` (\"UMA CTF Adapter v2\", \"Neg-risk UMA CTF Adapter (sports)\", ...), for the addresses we know by name. Null for any other address and when `resolved_by` is null: show the address then.","type":["string","null"]},"resolution_source":{"type":["string","null"]},"uma_bond":{"type":["number","null"]},"uma_reward":{"type":["number","null"]},"custom_liveness":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"neg_risk":{"type":"boolean"}},"required":["resolved_by","resolved_by_name","resolution_source","uma_bond","uma_reward","custom_liveness","neg_risk"],"additionalProperties":false},{"type":"null"}],"description":"The resolver and its parameters every question of the event shares. Null unless `oracle_uniform` is true."},"oracle_uniform":{"description":"True when every question names the same resolver with the same parameters (then `oracle` is it), false when they differ (read `questions[].oracle`), null when it is not known for at least one question or the event has no question.","type":["boolean","null"]},"dates":{"type":"object","properties":{"created":{"type":["string","null"]},"trading_opens":{"type":["string","null"]},"first_trade":{"type":["string","null"]},"event_start":{"type":["string","null"]},"scheduled_close":{"type":["string","null"]},"actual_close":{"type":["string","null"]}},"required":["created","trading_opens","first_trade","event_start","scheduled_close","actual_close"],"additionalProperties":false},"totals":{"type":"object","properties":{"questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"open_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolved_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"volume_24h_usdc":{"type":"number"},"volume_all_time_usd":{"type":"number"},"fills_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fills_24h_top_taker_share":{"type":["number","null"]},"fills_24h_median_usd":{"type":["number","null"]},"traders_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["questions","open_questions","resolved_questions","volume_24h_usdc","volume_all_time_usd","fills_24h","fills_24h_top_taker_share","fills_24h_median_usd","traders_24h"],"additionalProperties":false},"gamma_reported":{"type":"object","properties":{"open_interest":{"type":["number","null"]},"volume_24h_shares":{"type":["number","null"]},"liquidity":{"type":["number","null"]},"comment_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["open_interest","volume_24h_shares","liquidity","comment_count"],"additionalProperties":false},"fixture_events":{"type":"array","items":{"type":"object","properties":{"event_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"slug":{"type":"string"},"title":{"type":"string"},"market_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_current":{"type":"boolean"}},"required":["event_id","slug","title","market_count","is_current"],"additionalProperties":false}},"questions":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"title":{"type":"string"},"label":{"type":"string"},"group":{"type":"string"},"sports_market_type":{"type":"string"},"line":{"type":["number","null"]},"yes_mid":{"type":["number","null"]},"no_mid":{"type":["number","null"]},"quoted":{"type":"boolean"},"price_basis":{"anyOf":[{"type":"string","enum":["mid","last_trade"]},{"type":"null"}]},"has_traded":{"type":"boolean"},"fee":{"anyOf":[{"type":"object","properties":{"fee_type":{"type":["string","null"]},"fee_rate":{"type":["number","null"]},"fee_rebate_rate":{"type":["number","null"]},"fee_taker_only":{"type":["boolean","null"]}},"required":["fee_type","fee_rate","fee_rebate_rate","fee_taker_only"],"additionalProperties":false},{"type":"null"}]},"oracle":{"anyOf":[{"type":"object","properties":{"resolved_by":{"type":["string","null"]},"resolved_by_name":{"description":"A human name for `resolved_by` (\"UMA CTF Adapter v2\", \"Neg-risk UMA CTF Adapter (sports)\", ...), for the addresses we know by name. Null for any other address and when `resolved_by` is null: show the address then.","type":["string","null"]},"resolution_source":{"type":["string","null"]},"uma_bond":{"type":["number","null"]},"uma_reward":{"type":["number","null"]},"custom_liveness":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"neg_risk":{"type":"boolean"}},"required":["resolved_by","resolved_by_name","resolution_source","uma_bond","uma_reward","custom_liveness","neg_risk"],"additionalProperties":false},{"type":"null"}]},"yes_mid_as_of":{"type":["string","null"]},"no_mid_as_of":{"type":["string","null"]},"yes_token_id":{"type":"string"},"no_token_id":{"type":"string"},"volume_24h_usdc":{"type":"number"},"fills_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"market_state":{"type":"string","enum":["LIVE","RESOLVING","RESOLVED","DORMANT"]},"scheduled_close":{"type":["string","null"]},"neg_risk_market_id":{"type":"string"},"yes_mid_freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"no_mid_freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false}},"required":["condition_id","title","label","group","sports_market_type","line","yes_mid","no_mid","quoted","price_basis","has_traded","fee","oracle","yes_mid_as_of","no_mid_as_of","yes_token_id","no_token_id","volume_24h_usdc","fills_24h","resolved","winner_outcome","market_state","scheduled_close","neg_risk_market_id","yes_mid_freshness","no_mid_freshness"],"additionalProperties":false}},"live_check":{"type":"object","properties":{"mode":{"type":"string","enum":["off","record","on"]},"stale":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"refreshed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deferred":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fetch_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","stale","refreshed","deferred","fetch_ms"],"additionalProperties":false},"freshness":{"type":"object","properties":{"mids_as_of":{"type":["string","null"]}},"required":["mids_as_of"],"additionalProperties":false},"neg_risk_groups":{"type":"array","items":{"type":"object","properties":{"neg_risk_market_id":{"type":"string"},"n_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_priced":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sum_yes":{"type":"number"}},"required":["neg_risk_market_id","n_questions","n_priced","sum_yes"],"additionalProperties":false}},"as_of":{"type":"string"}},"required":["slug","canonical_slug","event_id","title","description","category","subcategory","market_subcategory","market_subcategory_label","market_subtype","market_subtype_label","series_title","series_slug","series_recurrence","sport_code","sport_name","sport_discipline","team_names","team_abbrs","game_id","live","ended","score","period","resolution_source","neg_risk","fee","fee_uniform","oracle","oracle_uniform","dates","totals","gamma_reported","fixture_events","questions","live_check","freshness","neg_risk_groups","as_of"],"additionalProperties":false}}}}},"operationId":"get-event","summary":"GET /v1/event/{slug}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/event/{slug}/traders":{"get":{"tags":["market"],"description":"Who is trading an event: the largest holders of its leading open questions, the best-ranked wallets that traded them in the last 24 h (ranked by price-adjusted edge, never by P&L, win rate or raw Brier) with what they hold, and the net tagged-wallet flow per question, plus the event 24 h traders, 24 h volume and all-time volume. Holders are open to every signed-in caller; the active and tagged-flow panels need metrics_full and come back status \"locked\" without it.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":160},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"canonical_slug":{"type":"string"},"event_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"traders_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Distinct TAKER wallets with a fill in the last 24 h on ANY question of the event (poly.fills_dedup.taker_proxy; the maker side is not attributed there). The same number as `totals.traders_24h` on /v1/event/:slug. `active.n_active` is a different count (makers too, covered questions only) and may exceed it."},"volume_24h_usd":{"type":"number"},"volume_all_time_usd":{"type":"number"},"open_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"caps":{"type":"object","properties":{"holder_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"holders_per_question":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"active_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"active_wallets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["holder_questions","holders_per_question","active_questions","active_wallets"],"additionalProperties":false},"holders":{"type":"object","properties":{"status":{"type":"string","enum":["ok","locked","unavailable"]},"questions":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"label":{"type":"string"},"title":{"type":"string"},"volume_24h_usd":{"type":"number"},"rows":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"outcome_side":{"type":"string","enum":["YES","NO"]},"shares_held":{"type":"number"},"avg_cost":{"type":["number","null"]},"has_mid":{"type":"boolean"},"current_value":{"type":["number","null"]},"unrealized_pnl":{"type":["number","null"]}},"required":["proxy_wallet","display_name","outcome_side","shares_held","avg_cost","has_mid","current_value","unrealized_pnl"],"additionalProperties":false}}},"required":["condition_id","label","title","volume_24h_usd","rows"],"additionalProperties":false}},"positions_as_of":{"type":["string","null"]},"as_of":{"type":["string","null"]}},"required":["status","questions","positions_as_of","as_of"],"additionalProperties":false},"active":{"type":"object","properties":{"status":{"type":"string","enum":["ok","locked","unavailable"]},"required_feature":{"type":["string","null"]},"window_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rows":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"rank_reason":{"type":"string","enum":["category_sk_14d","category_sk_90d","calibration_excess_z"]},"skill":{"type":"object","properties":{"sk_14d":{"type":["number","null"]},"n_14d":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"sk_90d":{"type":["number","null"]},"n_90d":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"calibration_excess_z":{"type":["number","null"]},"calibration_excess_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["sk_14d","n_14d","sk_90d","n_90d","calibration_excess_z","calibration_excess_n"],"additionalProperties":false},"tags":{"type":"array","items":{"type":"string"}},"last_activity_at":{"type":["string","null"]},"positions":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"label":{"type":"string"},"title":{"type":"string"},"side":{"type":"string","enum":["YES","NO","HEDGED"]},"entry_price":{"type":["number","null"]},"size_usdc":{"type":["number","null"]},"shares":{"type":["number","null"]},"activity":{"type":"string","enum":["holding","traded","both"]},"last_activity_at":{"type":["string","null"]}},"required":["condition_id","label","title","side","entry_price","size_usdc","shares","activity","last_activity_at"],"additionalProperties":false}}},"required":["proxy_wallet","display_name","rank_reason","skill","tags","last_activity_at","positions"],"additionalProperties":false}},"n_active":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Distinct wallets with at least one fill of their own in the window on a COVERED question (`questions`), on either side of the trade: maker or taker (poly.wallet_fills). A wallet that only holds a position is not counted. Not comparable with the top-level `traders_24h`, which counts TAKER wallets only, over every question of the event: this number can be the larger one. Not the market route’s `summary.n_active` either, which also counts wallets that hold without a recent fill. Null when no ranked wallet came back: the count rides the ranked rows, and an unknown is not a zero."},"n_ranked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Of the `n_active` wallets, the ones with a rank (the population `rows` is the top of)."},"questions":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"label":{"type":"string"},"title":{"type":"string"},"volume_24h_usd":{"type":"number"}},"required":["condition_id","label","title","volume_24h_usd"],"additionalProperties":false}},"positions_as_of":{"type":["string","null"]},"skill_as_of":{"anyOf":[{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},{"type":"null"}],"description":"The DAY of the skill snapshot the ranks were read from, as a calendar date (YYYY-MM-DD, UTC), not a timestamp: poly.wallet_category_skill.as_of_date, the same value the market route serves as `summary.skill_as_of`. Every other `*_as_of` in this response is a timestamp. Null when the skill grain is absent."},"as_of":{"type":["string","null"]}},"required":["status","required_feature","window_hours","rows","n_active","n_ranked","questions","positions_as_of","skill_as_of","as_of"],"additionalProperties":false},"tagged_flow":{"type":"object","properties":{"status":{"type":"string","enum":["ok","locked","unavailable"]},"required_feature":{"type":["string","null"]},"window_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"questions":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"label":{"type":"string"},"title":{"type":"string"},"volume_24h_usd":{"type":"number"},"flow":{"type":"object","properties":{"smart_net_yes_usdc":{"type":"number"},"crowd_net_yes_usdc":{"type":"number"},"smart_gross_usdc":{"type":"number"},"crowd_gross_usdc":{"type":"number"},"smart_wallets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"crowd_wallets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"smart_buy_yes_share":{"type":["number","null"]},"smart_lean":{"type":"string","enum":["YES","NO","BALANCED"]},"diverges":{"type":"boolean"}},"required":["smart_net_yes_usdc","crowd_net_yes_usdc","smart_gross_usdc","crowd_gross_usdc","smart_wallets","crowd_wallets","smart_buy_yes_share","smart_lean","diverges"],"additionalProperties":false}},"required":["condition_id","label","title","volume_24h_usd","flow"],"additionalProperties":false}},"as_of":{"type":["string","null"]}},"required":["status","required_feature","window_hours","questions","as_of"],"additionalProperties":false},"as_of":{"type":"string"}},"required":["slug","canonical_slug","event_id","traders_24h","volume_24h_usd","volume_all_time_usd","open_questions","caps","holders","active","tagged_flow","as_of"],"additionalProperties":false}}}}},"operationId":"get-event-traders","summary":"GET /v1/event/{slug}/traders","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/market/{conditionId}/active-traders":{"get":{"tags":["market"],"description":"Wallets active in this market, ranked by price-adjusted edge in the market's own category (never by P&L, win rate or raw Brier).","parameters":[{"schema":{"default":48,"type":"integer","minimum":1,"maximum":168},"in":"query","name":"active_hours","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"in":"path","name":"conditionId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"category":{"type":["string","null"]},"active_hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rows":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"display_name":{"type":["string","null"]},"side":{"type":"string","enum":["YES","NO","HEDGED"]},"entry_price":{"type":["number","null"]},"size_usdc":{"type":["number","null"]},"shares":{"type":["number","null"]},"unrealized_pnl":{"type":["number","null"]},"last_activity_at":{"type":["string","null"]},"activity":{"type":"string","enum":["holding","traded","both"]},"skill":{"type":"object","properties":{"category":{"type":["string","null"]},"sk_14d":{"type":["number","null"]},"n_14d":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"sk_90d":{"type":["number","null"]},"n_90d":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"luck_z_14d":{"type":["number","null"]},"calibration_excess_z":{"type":["number","null"]},"calibration_excess_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["category","sk_14d","n_14d","sk_90d","n_90d","luck_z_14d","calibration_excess_z","calibration_excess_n"],"additionalProperties":false},"rankable":{"type":"boolean"},"rank_reason":{"type":"string","enum":["category_sk_14d","category_sk_90d","calibration_excess_z","none"]},"tags":{"type":"array","items":{"type":"string"}}},"required":["proxy_wallet","display_name","side","entry_price","size_usdc","shares","unrealized_pnl","last_activity_at","activity","skill","rankable","rank_reason","tags"],"additionalProperties":false}},"summary":{"type":"object","properties":{"n_active":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_rankable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"yes_weight":{"type":"number"},"no_weight":{"type":"number"},"positions_as_of":{"type":["string","null"]},"skill_as_of":{"type":["string","null"]}},"required":["n_active","n_rankable","yes_weight","no_weight","positions_as_of","skill_as_of"],"additionalProperties":false},"lean":{"type":"object","properties":{"direction":{"type":"string","enum":["YES","NO","BALANCED"]},"evidence":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH"]},"s":{"type":"number"},"n_eff":{"type":"number"},"n_eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_voting":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"headline":{"type":"string"},"version":{"type":"string"}},"required":["direction","evidence","s","n_eff","n_eligible","n_voting","headline","version"],"additionalProperties":false}},"required":["condition_id","category","active_hours","rows","summary","lean"],"additionalProperties":false}}}}},"operationId":"get-market-active-traders","summary":"GET /v1/market/{conditionId}/active-traders","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/resolutions":{"get":{"tags":["resolutions"],"description":"Bulk since-cursor feed over on-chain condition resolutions, for mechanical settlement. Complements the market.resolved webhook: the webhook is push (fast, but missed while your receiver is down), this is pull (authoritative catch-up). See the `contract` field on the response.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"in":"query","name":"since_updated_at","required":false},{"schema":{"default":200,"type":"integer","minimum":1,"maximum":1000},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"binary_only","required":false,"description":"true / false / 1 / 0"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"question_id":{"type":"string"},"oracle":{"type":"string"},"outcome_slot_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"payout_numerators":{"type":"array","items":{"type":"string"}},"winner_outcome":{"type":["string","null"]},"winner_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_binary":{"type":"boolean"},"resolved_block":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolved_time":{"type":"string"},"source":{"type":"string"},"tx_hash":{"type":"string"},"log_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updated_at":{"type":"string"}},"required":["condition_id","question_id","oracle","outcome_slot_count","payout_numerators","winner_outcome","winner_index","is_binary","resolved_block","resolved_time","source","tx_hash","log_index","updated_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"contract":{"type":"object","properties":{"ordering":{"type":"string"},"backfill_caveat":{"type":"string"},"recommended_pattern":{"type":"string"}},"required":["ordering","backfill_caveat","recommended_pattern"],"additionalProperties":false}},"required":["rows","next_cursor","has_more","contract"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-resolutions","summary":"GET /v1/resolutions","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/search":{"get":{"tags":["search"],"description":"Universal resolver: address / partial address / condition_id / token_id / username / event, question, category or board text → grouped results (`groups`), plus the flat v1 `results`.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"query","name":"q","required":true},{"schema":{"default":8,"type":"integer","minimum":1,"maximum":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["traders","events","markets"]},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"category","required":false},{"schema":{"type":"string","maxLength":60,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"query","name":"subcategory","required":false},{"schema":{"type":"string","enum":["live","resolved"]},"in":"query","name":"state","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":200},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"kind":{"type":"string","enum":["address","condition_id","token_id","partial_address","text","empty"]},"results":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["trader"]},"proxy_wallet":{"type":"string"},"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"display_name":{"type":["string","null"]},"verified":{"type":"boolean"},"total_pnl":{"type":["number","null"]},"volume":{"type":["number","null"]},"has_metrics":{"type":"boolean"}},"required":["type","proxy_wallet","username","pseudonym","display_name","verified","total_pnl","volume","has_metrics"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["market"]},"condition_id":{"type":"string"},"slug":{"type":["string","null"]},"title":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"token_side":{"anyOf":[{"type":"string","enum":["YES","NO"]},{"type":"null"}]},"label":{"type":["string","null"]},"event_slug":{"type":["string","null"]},"event_title":{"type":["string","null"]},"live":{"type":"boolean"},"volume_24h":{"type":"number"},"yes_mid":{"type":["number","null"]}},"required":["type","condition_id","slug","title","category","subcategory","subcategory_label","subtype","subtype_label","resolved","winner_outcome"],"additionalProperties":false}]}},"corrected_query":{"type":["string","null"]},"groups":{"type":"object","properties":{"traders":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["trader"]},"proxy_wallet":{"type":"string"},"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"display_name":{"type":["string","null"]},"verified":{"type":"boolean"},"total_pnl":{"type":["number","null"]},"volume":{"type":["number","null"]},"has_metrics":{"type":"boolean"}},"required":["type","proxy_wallet","username","pseudonym","display_name","verified","total_pnl","volume","has_metrics"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["event"]},"id":{"type":"string"},"slug":{"type":["string","null"]},"title":{"type":"string"},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"subcategory_label":{"type":["string","null"]},"questions":{"type":"number"},"live":{"type":"boolean"},"resolved":{"type":"boolean"},"volume_24h":{"type":"number"},"volume_30d":{"type":"number"}},"required":["type","id","slug","title","category","subcategory","subcategory_label","questions","live","resolved","volume_24h","volume_30d"],"additionalProperties":false}},"markets":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["market"]},"condition_id":{"type":"string"},"slug":{"type":["string","null"]},"title":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"token_side":{"anyOf":[{"type":"string","enum":["YES","NO"]},{"type":"null"}]},"label":{"type":["string","null"]},"event_slug":{"type":["string","null"]},"event_title":{"type":["string","null"]},"live":{"type":"boolean"},"volume_24h":{"type":"number"},"yes_mid":{"type":["number","null"]}},"required":["type","condition_id","slug","title","category","subcategory","subcategory_label","subtype","subtype_label","resolved","winner_outcome"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["category"]},"category":{"type":"string"}},"required":["type","category"],"additionalProperties":false}},"boards":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["board"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"],"additionalProperties":false}}},"required":["traders","events","markets","categories","boards"],"additionalProperties":false},"total":{"type":"object","properties":{"traders":{"type":"number"},"events":{"type":"number"},"markets":{"type":"number"}},"required":["traders","events","markets"],"additionalProperties":false}},"required":["query","kind","results","corrected_query","groups","total"],"additionalProperties":false}}}}},"operationId":"get-search","summary":"GET /v1/search","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/public/search":{"get":{"tags":["public"],"description":"Anonymous masked resolver: the same grouped answer as /v1/search with opaque trader ids and no raw wallet.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":120},"in":"query","name":"q","required":true},{"schema":{"default":8,"type":"integer","minimum":1,"maximum":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["traders","events","markets"]},"in":"query","name":"type","required":false},{"schema":{"type":"string","minLength":1,"maxLength":40},"in":"query","name":"category","required":false},{"schema":{"type":"string","maxLength":60,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"in":"query","name":"subcategory","required":false},{"schema":{"type":"string","enum":["live","resolved"]},"in":"query","name":"state","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":200},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"kind":{"type":"string","enum":["address","condition_id","token_id","partial_address","text","empty"]},"results":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["trader"]},"tid":{"type":"string"},"wallet_label":{"type":"string"},"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"display_name":{"type":["string","null"]},"verified":{"type":"boolean"},"total_pnl":{"type":["number","null"]},"volume":{"type":["number","null"]},"has_metrics":{"type":"boolean"}},"required":["type","tid","wallet_label","username","pseudonym","display_name","verified","total_pnl","volume","has_metrics"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["market"]},"condition_id":{"type":"string"},"slug":{"type":["string","null"]},"title":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"token_side":{"anyOf":[{"type":"string","enum":["YES","NO"]},{"type":"null"}]},"label":{"type":["string","null"]},"event_slug":{"type":["string","null"]},"event_title":{"type":["string","null"]},"live":{"type":"boolean"},"volume_24h":{"type":"number"},"yes_mid":{"type":["number","null"]}},"required":["type","condition_id","slug","title","category","subcategory","subcategory_label","subtype","subtype_label","resolved","winner_outcome"],"additionalProperties":false}]}},"corrected_query":{"type":["string","null"]},"groups":{"type":"object","properties":{"traders":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["trader"]},"tid":{"type":"string"},"wallet_label":{"type":"string"},"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"display_name":{"type":["string","null"]},"verified":{"type":"boolean"},"total_pnl":{"type":["number","null"]},"volume":{"type":["number","null"]},"has_metrics":{"type":"boolean"}},"required":["type","tid","wallet_label","username","pseudonym","display_name","verified","total_pnl","volume","has_metrics"],"additionalProperties":false}},"events":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["event"]},"id":{"type":"string"},"slug":{"type":["string","null"]},"title":{"type":"string"},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"subcategory_label":{"type":["string","null"]},"questions":{"type":"number"},"live":{"type":"boolean"},"resolved":{"type":"boolean"},"volume_24h":{"type":"number"},"volume_30d":{"type":"number"}},"required":["type","id","slug","title","category","subcategory","subcategory_label","questions","live","resolved","volume_24h","volume_30d"],"additionalProperties":false}},"markets":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["market"]},"condition_id":{"type":"string"},"slug":{"type":["string","null"]},"title":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"token_side":{"anyOf":[{"type":"string","enum":["YES","NO"]},{"type":"null"}]},"label":{"type":["string","null"]},"event_slug":{"type":["string","null"]},"event_title":{"type":["string","null"]},"live":{"type":"boolean"},"volume_24h":{"type":"number"},"yes_mid":{"type":["number","null"]}},"required":["type","condition_id","slug","title","category","subcategory","subcategory_label","subtype","subtype_label","resolved","winner_outcome"],"additionalProperties":false}},"categories":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["category"]},"category":{"type":"string"}},"required":["type","category"],"additionalProperties":false}},"boards":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["board"]},"id":{"type":"string"},"name":{"type":"string"}},"required":["type","id","name"],"additionalProperties":false}}},"required":["traders","events","markets","categories","boards"],"additionalProperties":false},"total":{"type":"object","properties":{"traders":{"type":"number"},"events":{"type":"number"},"markets":{"type":"number"}},"required":["traders","events","markets"],"additionalProperties":false}},"required":["query","kind","results","corrected_query","groups","total"],"additionalProperties":false}}}}},"operationId":"get-public-search","summary":"GET /v1/public/search"}},"/v1/stats/overview":{"get":{"tags":["stats"],"description":"Public platform totals for the landing page (coarse aggregates only).","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"wallets":{"type":["number","null"]},"trades":{"type":["number","null"]},"markets":{"type":["number","null"]},"metrics":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"since_year":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["wallets","trades","markets","metrics","since_year"],"additionalProperties":false}}}}},"operationId":"get-stats-overview","summary":"GET /v1/stats/overview"}},"/v1/trader/{proxy}/tags":{"get":{"tags":["trader"],"description":"Smart-money tags for a trader (whale, sharp, early_bird, contrarian).","parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","enum":["whale","sharp","early_bird","contrarian"]},"score":{"type":"number"},"rationale":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["tag","score","rationale"],"additionalProperties":false}},"current_metrics":{"anyOf":[{"type":"object","properties":{"lifetime_volume_usdc":{"type":["number","null"]},"brier":{"type":["number","null"]},"counter_consensus_alpha":{"type":["number","null"]},"n_contrarian_fills":{"type":["number","null"]},"n_resolved":{"type":["number","null"]},"win_rate_pct":{"type":["number","null"]}},"required":["lifetime_volume_usdc","brier","counter_consensus_alpha","n_contrarian_fills","n_resolved","win_rate_pct"],"additionalProperties":false},{"type":"null"}]},"computed_at":{"type":["string","null"]}},"required":["proxy_wallet","tags","current_metrics","computed_at"],"additionalProperties":false}}}},"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-tags","summary":"GET /v1/trader/{proxy}/tags","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/trader/{proxy}/playbook":{"get":{"tags":["trader"],"description":"Trader Playbook: best categories, win rate by stake bucket, entry timing, position-size discipline, co-traders. Paid feature (metrics_full).","parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"best_categories":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"n_trades":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_resolved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":"number"},"pnl_usdc":{"type":["number","null"]},"brier":{"type":["number","null"]},"expectancy_usdc":{"type":["number","null"]}},"required":["category","n_trades","n_resolved","win_rate_pct","pnl_usdc","brier"],"additionalProperties":false}},"win_rate_by_stake_bucket":{"type":"array","items":{"type":"object","properties":{"bucket_label":{"type":"string"},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":"number"}},"required":["bucket_label","n","win_rate_pct"],"additionalProperties":false}},"entry_timing":{"type":"object","properties":{"median_lifetime_pct":{"type":["number","null"]},"n_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"alpha_when_early":{"type":["number","null"]}},"required":["median_lifetime_pct","n_fills","alpha_when_early"],"additionalProperties":false},"position_sizing":{"type":"object","properties":{"mean_notional":{"type":"number"},"cv":{"type":["number","null"]},"max_notional":{"type":"number"}},"required":["mean_notional","cv","max_notional"],"additionalProperties":false},"co_traders":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"shared_markets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["proxy_wallet","shared_markets"],"additionalProperties":false}}},"required":["proxy_wallet","best_categories","win_rate_by_stake_bucket","entry_timing","position_sizing","co_traders"],"additionalProperties":false}}}},"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-trader-playbook","summary":"GET /v1/trader/{proxy}/playbook","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/api-keys":{"get":{"tags":["api_keys"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"prefix":{"type":"string"},"label":{"type":["string","null"]},"last_used_at":{"type":["string","null"]},"created_at":{"type":"string"},"revoked_at":{"type":["string","null"]}},"required":["id","prefix","label","last_used_at","created_at","revoked_at"],"additionalProperties":false}}},"required":["rows"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-api-keys","summary":"GET /v1/api-keys","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["api_keys"],"description":"Mint a new API key. The cleartext secret is returned ONCE.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":80}}}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"prefix":{"type":"string"},"secret":{"type":"string","description":"Cleartext API key — shown ONCE; copy now or rotate."},"label":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","prefix","secret","label","created_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-api-keys","summary":"POST /v1/api-keys","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/api-keys/{id}":{"delete":{"tags":["api_keys"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"204":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-api-keys","summary":"DELETE /v1/api-keys/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/webhooks":{"get":{"tags":["webhooks"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"target_url":{"type":"string"},"event_types":{"type":"array","items":{"type":"string"}},"filter_json":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"active":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","target_url","event_types","filter_json","active","created_at"],"additionalProperties":false}}},"required":["rows"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-webhooks","summary":"GET /v1/webhooks","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["webhooks"],"description":"Create a webhook subscription. The signing_secret is returned ONCE.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_url":{"type":"string","pattern":"^https:\\/\\/"},"event_types":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["trader.fill","market.resolved","signal.smart_money"]}},"filter_json":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["target_url","event_types"]}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"target_url":{"type":"string"},"signing_secret":{"type":"string","description":"HMAC secret — shown ONCE. Store it; you cannot retrieve it later."},"event_types":{"type":"array","items":{"type":"string"}}},"required":["id","target_url","signing_secret","event_types"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-webhooks","summary":"POST /v1/webhooks","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/webhooks/{id}":{"put":{"tags":["webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"event_types":{"type":"array","items":{"type":"string","enum":["trader.fill","market.resolved","signal.smart_money"]}},"filter_json":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"no_changes":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"put-webhooks","summary":"PUT /v1/webhooks/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["webhooks"],"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"204":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-webhooks","summary":"DELETE /v1/webhooks/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/webhooks/{id}/test":{"post":{"tags":["webhooks"],"description":"Emit a synthetic test event onto the delivery queue.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"test_event_id":{"type":"string"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-webhooks-test","summary":"POST /v1/webhooks/{id}/test","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/profile/claims":{"get":{"tags":["profile"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"claims":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"proof_method":{"type":"string","enum":["direct_eoa_match","safe_owner"]},"siwe_eoa":{"type":"string"},"claimed_at":{"type":"string"}},"required":["proxy_wallet","proof_method","siwe_eoa","claimed_at"],"additionalProperties":false}}},"required":["claims"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-profile-claims","summary":"GET /v1/profile/claims","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/profile/claimable":{"get":{"tags":["profile"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"signer","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"signer":{"type":"string"},"proxies":{"type":"array","items":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"method":{"type":"string","enum":["direct_eoa_match","safe_owner"]},"claimed_by_me":{"type":"boolean"},"claimed_by_other":{"type":"boolean"}},"required":["proxy_wallet","method","claimed_by_me","claimed_by_other"],"additionalProperties":false}}},"required":["signer","proxies"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-profile-claimable","summary":"GET /v1/profile/claimable","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/profile/claim/{proxy}/eligibility":{"get":{"tags":["profile"],"parameters":[{"schema":{"type":"string"},"in":"query","name":"signer","required":false},{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"eligible":{"type":"boolean"},"method":{"anyOf":[{"type":"string","enum":["direct_eoa_match","safe_owner"]},{"type":"null"}]},"reason":{"type":"string"},"claimed_by_me":{"type":"boolean"},"claimed_by_other":{"type":"boolean"}},"required":["enabled","eligible","method","reason","claimed_by_me","claimed_by_other"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-profile-claim-eligibility","summary":"GET /v1/profile/claim/{proxy}/eligibility","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/profile/claim/{proxy}/challenge":{"post":{"tags":["profile"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"signer":{"type":"string"}},"required":["signer"]}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-profile-claim-challenge","summary":"POST /v1/profile/claim/{proxy}/challenge","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/profile/claim/{proxy}":{"post":{"tags":["profile"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":4000},"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"}},"required":["message","signature"]}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"proxy_wallet":{"type":"string"},"method":{"type":"string","enum":["direct_eoa_match","safe_owner"]}},"required":["ok","proxy_wallet","method"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-profile-claim","summary":"POST /v1/profile/claim/{proxy}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["profile"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-profile-claim","summary":"DELETE /v1/profile/claim/{proxy}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/alerts":{"get":{"tags":["alerts"],"description":"List the caller's alert rules (watchlist).","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":["string","null"]},"event_type":{"type":"string","enum":["trader.fill","market.resolved","signal.smart_money"]},"filter":{"type":"object","properties":{"trader_proxy":{},"condition_id":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"min_size_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"tags_any":{"maxItems":10,"type":"array","items":{"type":"string"}},"signal_types":{"maxItems":10,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"channels":{"type":"array","items":{"type":"string","enum":["in_app","email","browser_push"]}},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","event_type","filter","channels","active","created_at","updated_at"],"additionalProperties":false}}},"required":["rules"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-alerts","summary":"GET /v1/alerts","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["alerts"],"description":"Create an alert rule. trader.fill watches a wallet; min_size_usdc thresholds it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"event_type":{"default":"trader.fill","type":"string","enum":["trader.fill"]},"filter":{"type":"object","properties":{"trader_proxy":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"condition_id":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"min_size_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"tags_any":{"maxItems":10,"type":"array","items":{"type":"string"}},"signal_types":{"maxItems":10,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"channels":{"default":["in_app"],"minItems":1,"type":"array","items":{"type":"string","enum":["in_app","email","browser_push"]}},"active":{"default":true,"type":"boolean"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":["string","null"]},"event_type":{"type":"string","enum":["trader.fill","market.resolved","signal.smart_money"]},"filter":{"type":"object","properties":{"trader_proxy":{},"condition_id":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"min_size_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"tags_any":{"maxItems":10,"type":"array","items":{"type":"string"}},"signal_types":{"maxItems":10,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"channels":{"type":"array","items":{"type":"string","enum":["in_app","email","browser_push"]}},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","event_type","filter","channels","active","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-alerts","summary":"POST /v1/alerts","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/alerts/{id}":{"patch":{"tags":["alerts"],"description":"Update an alert rule (owner only).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}]},"filter":{"type":"object","properties":{"trader_proxy":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"condition_id":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"min_size_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"tags_any":{"maxItems":10,"type":"array","items":{"type":"string"}},"signal_types":{"maxItems":10,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"channels":{"minItems":1,"type":"array","items":{"type":"string","enum":["in_app","email","browser_push"]}},"active":{"type":"boolean"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":["string","null"]},"event_type":{"type":"string","enum":["trader.fill","market.resolved","signal.smart_money"]},"filter":{"type":"object","properties":{"trader_proxy":{},"condition_id":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"min_size_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"tags_any":{"maxItems":10,"type":"array","items":{"type":"string"}},"signal_types":{"maxItems":10,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"channels":{"type":"array","items":{"type":"string","enum":["in_app","email","browser_push"]}},"active":{"type":"boolean"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","name","event_type","filter","channels","active","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-alerts","summary":"PATCH /v1/alerts/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["alerts"],"description":"Delete an alert rule (owner only).","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-alerts","summary":"DELETE /v1/alerts/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/notifications":{"get":{"tags":["alerts"],"description":"Recent notifications (newest first) + unread count. With alert settings on (ALERT_SETTINGS_ENABLED) each row also carries `kind`, `delivery` and `summary_id`, every alert has a row whatever its delivery, and the unread count counts only rows delivered one by one and summaries.","parameters":[{"schema":{"default":30,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"notifications":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"title":{"type":"string"},"body":{"type":["string","null"]},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"read_at":{"type":["string","null"]},"created_at":{"type":"string"},"kind":{"description":"Only with alert settings on. The alert kind of the row; null for a type outside the alert settings (a custom rule, a summary) and for rows written before them.","anyOf":[{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]},{"type":"null"}]},"delivery":{"description":"Only with alert settings on. How the row reached the user: `instant` was sent one by one; `summary` (the timing the user chose), `over_allowance` (the allowance was spent) and `weekend` (weekdays only) were kept for a summary.","type":"string","enum":["instant","summary","over_allowance","weekend"]},"summary_id":{"description":"Only with alert settings on. The `alerts.summary` notification that announced the row, once one did.","anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","type","title","body","data","read_at","created_at"],"additionalProperties":false}},"unread_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["notifications","unread_count"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-notifications","summary":"GET /v1/notifications","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/notifications/unread-count":{"get":{"tags":["alerts"],"description":"Cheap unread-count poll for the notification bell.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"unread_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["unread_count"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-notifications-unread-count","summary":"GET /v1/notifications/unread-count","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/notifications/read":{"post":{"tags":["alerts"],"description":"Mark notifications read (by id, or all).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"anyOf":[{"maxItems":200,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"string","enum":["all"]}]}},"required":["ids"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"updated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["updated"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-notifications-read","summary":"POST /v1/notifications/read","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/notifications/prefs":{"get":{"tags":["alerts"],"description":"Notification channel preferences.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"in_app":{"type":"boolean"},"email":{"type":"boolean"},"browser_push":{"type":"boolean"}},"required":["in_app","email","browser_push"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-notifications-prefs","summary":"GET /v1/notifications/prefs","security":[{"apiKey":[]},{"sessionCookie":[]}]},"put":{"tags":["alerts"],"description":"Update notification channel preferences (upsert).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"in_app":{"type":"boolean"},"email":{"type":"boolean"},"browser_push":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"in_app":{"type":"boolean"},"email":{"type":"boolean"},"browser_push":{"type":"boolean"}},"required":["in_app","email","browser_push"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"put-notifications-prefs","summary":"PUT /v1/notifications/prefs","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/follows":{"get":{"tags":["follows"],"description":"The authenticated user's follows (traders + markets + events). Event items carry `event` (title, question counts, status). With alert settings on (ALERT_SETTINGS_ENABLED), trader and event items also carry `uses_default` and `alerts`, the follow's effective alert choice.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"follows":{"type":"array","items":{"type":"object","properties":{"target_type":{"type":"string","enum":["trader","market","event"]},"target_id":{"type":"string"},"notify":{"type":"boolean"},"created_at":{"type":"string"},"event":{"description":"Only on GET /v1/follows items with target_type 'event'. Null when the slug no longer resolves to an event or the read failed: the follow still exists and can be removed.","anyOf":[{"type":"object","properties":{"slug":{"type":"string","description":"The event's canonical slug today: link to /event/. Equal to the follow's target_id unless the fixture's canonical event changed since the follow was written."},"title":{"type":"string","description":"The canonical event's title (poly.events.title)."},"image_url":{"description":"Always null today: no event image is stored. Reserved so a later one is not a contract change.","type":["string","null"]},"questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Questions of the fixture: the `totals.questions` of GET /v1/event/:slug."},"open_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unresolved questions of the fixture: the `totals.open_questions` of GET /v1/event/:slug."},"status":{"type":"string","enum":["open","resolved","no_questions"],"description":"'open' while at least one question is unresolved, 'resolved' when every question is resolved, 'no_questions' when the event lists none yet."}},"required":["slug","title","image_url","questions","open_questions","status"],"additionalProperties":false},{"type":"null"}]},"uses_default":{"description":"Only with alert settings on, on trader and event follows. True while the follow was never edited: `alerts` is then the account default, resolved now, and moves with it.","type":"boolean"},"alerts":{"description":"Only with alert settings on, on trader and event follows: the EFFECTIVE choice. `kinds` are the alert kinds that are on (empty = nothing is sent, the bell may still be on), `level` is quiet, balanced or everything, `custom` the custom amounts in force (null when there are none or the plan does not allow them).","type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]},"custom":{"anyOf":[{"type":"object","properties":{"min_trade_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"price_move_points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},{"type":"null"}]}},"required":["kinds","level","custom"],"additionalProperties":false}},"required":["target_type","target_id","notify","created_at"],"additionalProperties":false}}},"required":["follows"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-follows","summary":"GET /v1/follows","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["follows"],"description":"Follow a trader, market or event. notify=true (default) is the bell: big-fill alerts for a trader, the event alerts for an event. An event's target_id is any slug of it; the response carries the canonical slug it was stored under. Event follows do not count against the trader follow cap; they have their own plan cap (`followed_events_max`: Free 3, paid 200) and past it the answer is 403 `forbidden` with the limit in the message. With alert settings on (ALERT_SETTINGS_ENABLED) the body may carry `alerts` (trader and event follows only) and the answer carries `uses_default` and `alerts`; without `alerts` a new follow uses the account default. Custom amounts on a plan without them are 403 `plan_required` with `feature: alerts_custom_thresholds`; an amount outside its bounds is 400 `invalid_custom` with `field`; a kind of another follow type is 400 `invalid_kind`. A refused request writes nothing.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_type":{"type":"string","enum":["trader","market","event"]},"target_id":{"type":"string"},"notify":{"default":true,"type":"boolean"},"alerts":{"description":"Only with alert settings on. A partial of the follow’s own choice: `kinds`, `level`, `custom` ({ min_trade_usd, price_move_points } or null to clear). The first such write makes the follow its own, starting from the account default as it is then. `null` puts the follow back on the account default.","anyOf":[{"type":"object","properties":{"kinds":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":40}},"level":{"type":"string","enum":["quiet","balanced","everything"]},"custom":{"anyOf":[{"type":"object","properties":{"min_trade_usd":{"type":["number","null"]},"price_move_points":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["target_type","target_id"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"target_type":{"type":"string","enum":["trader","market","event"]},"target_id":{"type":"string"},"notify":{"type":"boolean"},"created_at":{"type":"string"},"event":{"description":"Only on GET /v1/follows items with target_type 'event'. Null when the slug no longer resolves to an event or the read failed: the follow still exists and can be removed.","anyOf":[{"type":"object","properties":{"slug":{"type":"string","description":"The event's canonical slug today: link to /event/. Equal to the follow's target_id unless the fixture's canonical event changed since the follow was written."},"title":{"type":"string","description":"The canonical event's title (poly.events.title)."},"image_url":{"description":"Always null today: no event image is stored. Reserved so a later one is not a contract change.","type":["string","null"]},"questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Questions of the fixture: the `totals.questions` of GET /v1/event/:slug."},"open_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unresolved questions of the fixture: the `totals.open_questions` of GET /v1/event/:slug."},"status":{"type":"string","enum":["open","resolved","no_questions"],"description":"'open' while at least one question is unresolved, 'resolved' when every question is resolved, 'no_questions' when the event lists none yet."}},"required":["slug","title","image_url","questions","open_questions","status"],"additionalProperties":false},{"type":"null"}]},"uses_default":{"description":"Only with alert settings on, on trader and event follows. True while the follow was never edited: `alerts` is then the account default, resolved now, and moves with it.","type":"boolean"},"alerts":{"description":"Only with alert settings on, on trader and event follows: the EFFECTIVE choice. `kinds` are the alert kinds that are on (empty = nothing is sent, the bell may still be on), `level` is quiet, balanced or everything, `custom` the custom amounts in force (null when there are none or the plan does not allow them).","type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]},"custom":{"anyOf":[{"type":"object","properties":{"min_trade_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"price_move_points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},{"type":"null"}]}},"required":["kinds","level","custom"],"additionalProperties":false}},"required":["target_type","target_id","notify","created_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-follows","summary":"POST /v1/follows","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/follows/recent-fills":{"get":{"tags":["follows"],"description":"Recent large fills from the caller's followed wallets (live-feed backfill).","parameters":[{"schema":{"default":40,"type":"integer","minimum":1,"maximum":60},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"fills":{"type":"array","items":{"type":"object","properties":{"taker":{"type":"string"},"usdc_size":{"type":"number"},"token_id":{"type":"string"},"taker_side":{"type":"string","enum":["buy","sell"]},"outcome_side":{"type":"string","enum":["YES","NO"]},"price":{"type":"number"},"ts":{"type":"number"},"tx_hash":{"type":"string"}},"required":["taker","usdc_size","token_id","taker_side","outcome_side","price","ts","tx_hash"],"additionalProperties":false}}},"required":["fills"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-follows-recent-fills","summary":"GET /v1/follows/recent-fills","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/follows/{type}/{id}":{"patch":{"tags":["follows"],"description":"Toggle the notify bell on a follow (owner only). For an event, :id is the stored target_id (the canonical slug) or any slug of the fixture. `notify` is required while alert settings are off. With alert settings on (ALERT_SETTINGS_ENABLED) the body takes `notify`, `alerts` or both (at least one): `alerts` is a partial of the follow’s own choice and `alerts: null` puts the follow back on the account default; the answer carries `uses_default` and `alerts`. The refusals are those of POST /v1/follows (`plan_required`, `invalid_custom`, `invalid_kind`), and a refused request writes nothing.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notify":{"type":"boolean"},"alerts":{"description":"Only with alert settings on. A partial of the follow’s own choice: `kinds`, `level`, `custom` ({ min_trade_usd, price_move_points } or null to clear). The first such write makes the follow its own, starting from the account default as it is then. `null` puts the follow back on the account default.","anyOf":[{"type":"object","properties":{"kinds":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":40}},"level":{"type":"string","enum":["quiet","balanced","everything"]},"custom":{"anyOf":[{"type":"object","properties":{"min_trade_usd":{"type":["number","null"]},"price_move_points":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}}}}}},"parameters":[{"schema":{"type":"string","enum":["trader","market","event"]},"in":"path","name":"type","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"target_type":{"type":"string","enum":["trader","market","event"]},"target_id":{"type":"string"},"notify":{"type":"boolean"},"created_at":{"type":"string"},"event":{"description":"Only on GET /v1/follows items with target_type 'event'. Null when the slug no longer resolves to an event or the read failed: the follow still exists and can be removed.","anyOf":[{"type":"object","properties":{"slug":{"type":"string","description":"The event's canonical slug today: link to /event/. Equal to the follow's target_id unless the fixture's canonical event changed since the follow was written."},"title":{"type":"string","description":"The canonical event's title (poly.events.title)."},"image_url":{"description":"Always null today: no event image is stored. Reserved so a later one is not a contract change.","type":["string","null"]},"questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Questions of the fixture: the `totals.questions` of GET /v1/event/:slug."},"open_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unresolved questions of the fixture: the `totals.open_questions` of GET /v1/event/:slug."},"status":{"type":"string","enum":["open","resolved","no_questions"],"description":"'open' while at least one question is unresolved, 'resolved' when every question is resolved, 'no_questions' when the event lists none yet."}},"required":["slug","title","image_url","questions","open_questions","status"],"additionalProperties":false},{"type":"null"}]},"uses_default":{"description":"Only with alert settings on, on trader and event follows. True while the follow was never edited: `alerts` is then the account default, resolved now, and moves with it.","type":"boolean"},"alerts":{"description":"Only with alert settings on, on trader and event follows: the EFFECTIVE choice. `kinds` are the alert kinds that are on (empty = nothing is sent, the bell may still be on), `level` is quiet, balanced or everything, `custom` the custom amounts in force (null when there are none or the plan does not allow them).","type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]},"custom":{"anyOf":[{"type":"object","properties":{"min_trade_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"price_move_points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},{"type":"null"}]}},"required":["kinds","level","custom"],"additionalProperties":false}},"required":["target_type","target_id","notify","created_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-follows","summary":"PATCH /v1/follows/{type}/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["follows"],"description":"Unfollow (owner only).","parameters":[{"schema":{"type":"string","enum":["trader","market","event"]},"in":"path","name":"type","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-follows","summary":"DELETE /v1/follows/{type}/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/alerts/settings":{"get":{"tags":["alerts"],"description":"The account’s alert settings: timezone, the hour of the daily summary, weekdays-only, one delivery mode per kind, the default kinds and level of an unedited follow per follow type, the channel switches, whether the plan allows custom amounts, the sentence to show for each level, the bounds of a custom amount and the allowance meter. An account that never saved anything gets the defaults. Session only. 404 `alert_settings_disabled` while ALERT_SETTINGS_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"IANA name; \"UTC\" until the user sets one."},"summary_hour":{"type":"integer","minimum":0,"maximum":23,"description":"Local hour of the daily summary."},"weekdays_only":{"type":"boolean"},"delivery":{"type":"object","properties":{"trader_fill":{"type":"string","enum":["instant","hourly","daily"]},"trader_board":{"type":"string","enum":["instant","hourly","daily"]},"event_resolved":{"type":"string","enum":["instant","hourly","daily"]},"event_added":{"type":"string","enum":["instant","hourly","daily"]},"event_price_move":{"type":"string","enum":["instant","hourly","daily"]},"event_notable_wallet":{"type":"string","enum":["instant","hourly","daily"]}},"required":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"],"additionalProperties":false,"description":"One mode per kind."},"defaults":{"type":"object","properties":{"trader":{"type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]}},"required":["kinds","level"],"additionalProperties":false},"event":{"type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]}},"required":["kinds","level"],"additionalProperties":false}},"required":["trader","event"],"additionalProperties":false,"description":"What every follow with uses_default: true resolves to."},"channels":{"type":"object","properties":{"in_app":{"type":"boolean"},"email":{"type":"boolean"},"browser_push":{"type":"boolean"}},"required":["in_app","email","browser_push"],"additionalProperties":false},"can_custom":{"type":"boolean","description":"The plan allows custom amounts."},"levels":{"type":"object","properties":{"trader_fill":{"type":"object","properties":{"quiet":{"type":"string"},"balanced":{"type":"string"},"everything":{"type":"string"}},"required":["quiet","balanced","everything"],"additionalProperties":false},"event_price_move":{"type":"object","properties":{"quiet":{"type":"string"},"balanced":{"type":"string"},"everything":{"type":"string"}},"required":["quiet","balanced","everything"],"additionalProperties":false},"event_notable_wallet":{"type":"object","properties":{"quiet":{"type":"string"},"balanced":{"type":"string"},"everything":{"type":"string"}},"required":["quiet","balanced","everything"],"additionalProperties":false}},"required":["trader_fill","event_price_move","event_notable_wallet"],"additionalProperties":false,"description":"The sentence to show per kind and level. The web shows no number of its own."},"custom_bounds":{"type":"object","properties":{"trader":{"type":"object","properties":{"min_trade_usd":{"type":"array","prefixItems":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2}},"required":["min_trade_usd"],"additionalProperties":false},"event":{"type":"object","properties":{"min_trade_usd":{"type":"array","prefixItems":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2},"price_move_points":{"type":"array","prefixItems":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2}},"required":["min_trade_usd","price_move_points"],"additionalProperties":false}},"required":["trader","event"],"additionalProperties":false},"timezone_set":{"type":"boolean","description":"False while no timezone was saved: the web may send the browser zone once."},"allowance":{"type":"object","properties":{"plan":{"type":"string"},"day":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Alerts sent one by one in the period (UTC)."},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"null means unlimited."},"resets_at":{"type":"string","description":"The UTC instant the period ends; print it in local time."}},"required":["used","limit","resets_at"],"additionalProperties":false},"month":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Alerts sent one by one in the period (UTC)."},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"null means unlimited."},"resets_at":{"type":"string","description":"The UTC instant the period ends; print it in local time."}},"required":["used","limit","resets_at"],"additionalProperties":false},"over":{"type":"boolean","description":"True when either limit is reached."},"upgrade":{"type":"boolean","description":"True when some plan has a higher limit: show the upgrade note."}},"required":["plan","day","month","over","upgrade"],"additionalProperties":false}},"required":["timezone","summary_hour","weekdays_only","delivery","defaults","channels","can_custom","levels","custom_bounds","timezone_set","allowance"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-alerts-settings","summary":"GET /v1/alerts/settings","security":[{"apiKey":[]},{"sessionCookie":[]}]},"put":{"tags":["alerts"],"description":"Save a part of the alert settings; every key is optional and an absent key is kept. `delivery` is a partial map kind → instant | hourly | daily. `defaults.trader` and `defaults.event` each take `kinds` and/or `level`; a change applies at once to every follow that still has `uses_default: true` and to no follow that was edited. `channels` is a partial of the channel switches. Answers the whole object of GET. 400 `invalid_timezone` for a zone name the server does not know; 400 `invalid_kind` for a name that is not a kind, or a kind of the other follow type. Session only. 404 `alert_settings_disabled` while ALERT_SETTINGS_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","minLength":1,"maxLength":64},"summary_hour":{"type":"integer","minimum":0,"maximum":23},"weekdays_only":{"type":"boolean"},"delivery":{"description":"A partial map kind → mode.","type":"object","propertyNames":{"type":"string","maxLength":40},"additionalProperties":{"type":"string","enum":["instant","hourly","daily"]}},"defaults":{"type":"object","properties":{"trader":{"type":"object","properties":{"kinds":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":40}},"level":{"type":"string","enum":["quiet","balanced","everything"]}},"additionalProperties":false},"event":{"type":"object","properties":{"kinds":{"maxItems":12,"type":"array","items":{"type":"string","maxLength":40}},"level":{"type":"string","enum":["quiet","balanced","everything"]}},"additionalProperties":false}},"additionalProperties":false},"channels":{"type":"object","properties":{"in_app":{"type":"boolean"},"email":{"type":"boolean"},"browser_push":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"IANA name; \"UTC\" until the user sets one."},"summary_hour":{"type":"integer","minimum":0,"maximum":23,"description":"Local hour of the daily summary."},"weekdays_only":{"type":"boolean"},"delivery":{"type":"object","properties":{"trader_fill":{"type":"string","enum":["instant","hourly","daily"]},"trader_board":{"type":"string","enum":["instant","hourly","daily"]},"event_resolved":{"type":"string","enum":["instant","hourly","daily"]},"event_added":{"type":"string","enum":["instant","hourly","daily"]},"event_price_move":{"type":"string","enum":["instant","hourly","daily"]},"event_notable_wallet":{"type":"string","enum":["instant","hourly","daily"]}},"required":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"],"additionalProperties":false,"description":"One mode per kind."},"defaults":{"type":"object","properties":{"trader":{"type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]}},"required":["kinds","level"],"additionalProperties":false},"event":{"type":"object","properties":{"kinds":{"type":"array","items":{"type":"string","enum":["trader_fill","trader_board","event_resolved","event_added","event_price_move","event_notable_wallet"]}},"level":{"type":"string","enum":["quiet","balanced","everything"]}},"required":["kinds","level"],"additionalProperties":false}},"required":["trader","event"],"additionalProperties":false,"description":"What every follow with uses_default: true resolves to."},"channels":{"type":"object","properties":{"in_app":{"type":"boolean"},"email":{"type":"boolean"},"browser_push":{"type":"boolean"}},"required":["in_app","email","browser_push"],"additionalProperties":false},"can_custom":{"type":"boolean","description":"The plan allows custom amounts."},"levels":{"type":"object","properties":{"trader_fill":{"type":"object","properties":{"quiet":{"type":"string"},"balanced":{"type":"string"},"everything":{"type":"string"}},"required":["quiet","balanced","everything"],"additionalProperties":false},"event_price_move":{"type":"object","properties":{"quiet":{"type":"string"},"balanced":{"type":"string"},"everything":{"type":"string"}},"required":["quiet","balanced","everything"],"additionalProperties":false},"event_notable_wallet":{"type":"object","properties":{"quiet":{"type":"string"},"balanced":{"type":"string"},"everything":{"type":"string"}},"required":["quiet","balanced","everything"],"additionalProperties":false}},"required":["trader_fill","event_price_move","event_notable_wallet"],"additionalProperties":false,"description":"The sentence to show per kind and level. The web shows no number of its own."},"custom_bounds":{"type":"object","properties":{"trader":{"type":"object","properties":{"min_trade_usd":{"type":"array","prefixItems":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2}},"required":["min_trade_usd"],"additionalProperties":false},"event":{"type":"object","properties":{"min_trade_usd":{"type":"array","prefixItems":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2},"price_move_points":{"type":"array","prefixItems":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}],"items":false,"minItems":2,"maxItems":2}},"required":["min_trade_usd","price_move_points"],"additionalProperties":false}},"required":["trader","event"],"additionalProperties":false},"timezone_set":{"type":"boolean","description":"False while no timezone was saved: the web may send the browser zone once."},"allowance":{"type":"object","properties":{"plan":{"type":"string"},"day":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Alerts sent one by one in the period (UTC)."},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"null means unlimited."},"resets_at":{"type":"string","description":"The UTC instant the period ends; print it in local time."}},"required":["used","limit","resets_at"],"additionalProperties":false},"month":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Alerts sent one by one in the period (UTC)."},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"null means unlimited."},"resets_at":{"type":"string","description":"The UTC instant the period ends; print it in local time."}},"required":["used","limit","resets_at"],"additionalProperties":false},"over":{"type":"boolean","description":"True when either limit is reached."},"upgrade":{"type":"boolean","description":"True when some plan has a higher limit: show the upgrade note."}},"required":["plan","day","month","over","upgrade"],"additionalProperties":false}},"required":["timezone","summary_hour","weekdays_only","delivery","defaults","channels","can_custom","levels","custom_bounds","timezone_set","allowance"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"put-alerts-settings","summary":"PUT /v1/alerts/settings","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/alerts/allowance":{"get":{"tags":["alerts"],"description":"The allowance meter: how many alerts were sent to the account one by one in the current UTC day and month, against the plan’s limits (`limit: null` is unlimited), with the instant each period ends. `over` is true when either limit is reached; `upgrade` is true when some plan has a higher limit. Resolutions and alerts delivered in a summary are not counted. The same object is embedded in GET /v1/alerts/settings. Session only. 404 `alert_settings_disabled` while ALERT_SETTINGS_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"string"},"day":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Alerts sent one by one in the period (UTC)."},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"null means unlimited."},"resets_at":{"type":"string","description":"The UTC instant the period ends; print it in local time."}},"required":["used","limit","resets_at"],"additionalProperties":false},"month":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Alerts sent one by one in the period (UTC)."},"limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"null means unlimited."},"resets_at":{"type":"string","description":"The UTC instant the period ends; print it in local time."}},"required":["used","limit","resets_at"],"additionalProperties":false},"over":{"type":"boolean","description":"True when either limit is reached."},"upgrade":{"type":"boolean","description":"True when some plan has a higher limit: show the upgrade note."}},"required":["plan","day","month","over","upgrade"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-alerts-allowance","summary":"GET /v1/alerts/allowance","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/notifications/unsubscribe":{"post":{"tags":["alerts"],"description":"The one-click unsubscribe of an alert or summary mail. No session: `t` is the signed token from the mail. It names one account and does one thing: it switches that account’s email channel off (`channels.email = false`). It never expires, and a second call answers the same. A missing, malformed or wrongly signed token is 400 `invalid_token`. Accepts the mail client’s form body (`List-Unsubscribe=One-Click`) and ignores it. 404 `alert_settings_disabled` while ALERT_SETTINGS_ENABLED is off, or while the server holds no ALERT_UNSUBSCRIBE_SECRET.","parameters":[{"schema":{"type":"string","maxLength":2048},"in":"query","name":"t","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]},"email":{"type":"boolean","enum":[false]}},"required":["ok","email"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-notifications-unsubscribe","summary":"POST /v1/notifications/unsubscribe","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/templates":{"get":{"tags":["lab"],"description":"The Strategy Lab templates: the research families as ordinary strategy specs to copy and edit, each with the as-of evidence measured on the history (SIMULATED, per $10 copied) and its caveats. 404 `lab_disabled` while LAB_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"family":{"type":"string"},"description":{"type":"string"},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"evidence":{"type":"object","properties":{"window":{"type":"string"},"per10":{"type":"number"},"t":{"type":"number"},"copies_per_day":{"type":"number"},"note":{"type":"string"},"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"control_per10":{"type":["number","null"]},"without_best_wallet_per10":{"type":["number","null"]},"without_best_3_days_per10":{"type":["number","null"]},"kind":{"type":"string","enum":["copy","rules"]},"baseline_per10":{"type":["number","null"]},"t_clustered":{"type":["number","null"]},"events":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"without_best_market_per10":{"type":["number","null"]},"measured":{"type":"object","properties":{"on":{"type":"string"},"backtest_id":{"type":"string"},"how":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"}},"required":["on","from","to"],"additionalProperties":false}},"required":["window","per10","t","copies_per_day","note"],"additionalProperties":false},"caveats":{"type":"array","items":{"type":"string"}}},"required":["id","name","family","description","spec","evidence","caveats"],"additionalProperties":false}}},"required":["templates"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-templates","summary":"GET /v1/lab/templates","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/limits":{"get":{"tags":["lab"],"description":"The caller’s Strategy Lab allowance (plan keys) and what is used: saved strategies, backtests today (UTC), backtests queued or running, active paper runs. 404 `lab_disabled` while LAB_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"strategy_lab":{"type":"boolean"},"paper_trading":{"type":"boolean"},"lab_strategies_max":{"type":"number"},"lab_backtests_per_day":{"type":"number"},"lab_paper_runs_max":{"type":"number"},"agent_daily_usd":{"type":"number"},"lab_own_rules":{"type":"boolean"},"rules_paper":{"type":"boolean"},"used":{"type":"object","properties":{"strategies":{"type":"number"},"backtests_today":{"type":"number"},"pending_backtests":{"type":"number"},"active_paper_runs":{"type":"number"}},"required":["strategies","backtests_today","pending_backtests","active_paper_runs"],"additionalProperties":false}},"required":["strategy_lab","paper_trading","lab_strategies_max","lab_backtests_per_day","lab_paper_runs_max","agent_daily_usd","lab_own_rules","rules_paper","used"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-limits","summary":"GET /v1/lab/limits","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/strategies":{"get":{"tags":["lab"],"description":"The caller’s strategies, newest first, each with its latest backtest’s status and headline (per $10, copies). Archived ones only with include_archived. Listing needs no plan, so a downgraded account still sees what it built. 404 `lab_disabled` while LAB_ENABLED is off.","parameters":[{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"include_archived","required":false,"description":"true / false / 1 / 0"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"strategies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","backtested","paper","promotable","live","archived"]},"template_id":{"type":["string","null"]},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"last_backtest":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"created_at":{"type":"string"}},"required":["id","status","per10","copies","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","status","template_id","spec","created_at","updated_at","last_backtest"],"additionalProperties":false}}},"required":["strategies"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-strategies","summary":"GET /v1/lab/strategies","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["lab"],"description":"Save a strategy: a name and a spec (the strategy spec schema), or a template_id to copy a template’s spec (a spec given with it wins). A Builder-ranking source must name the caller’s own saved ranking or an inline config the daily snapshot can answer (else 400 with the reason). 403 `plan_required` (feature strategy_lab; a strategy that copies no wallet — wallet_source kind `none` — needs a plan with own rules, Quant and above), 400 `lab_strategies_max` at the plan’s limit. 404 `lab_disabled` while LAB_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"spec":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"wallet_source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["static"]},"wallets":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"min_price":{"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["wallet"],"additionalProperties":false}}},"required":["kind","wallets"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["history_ranking"]},"score":{"type":"string","enum":["edge","copier_return","drift_1h","drift_24h","clv","own_return"]},"window_days":{"default":60,"type":"integer","minimum":14,"maximum":120},"min_positions":{"default":20,"type":"integer","minimum":5,"maximum":1000},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":300},"skip_top":{"default":0,"type":"integer","minimum":0,"maximum":300},"score_filter":{"type":"object","properties":{"phases":{"minItems":1,"type":"array","items":{"type":"string","enum":["nonsports","pregame","inplay"]}},"min_price":{"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"type":"number","minimum":0.01,"maximum":0.99},"categories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"categories_out":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"min_lead_hours":{"type":"number","minimum":0,"maximum":720}},"additionalProperties":false},"one_per_operator":{"default":true,"type":"boolean"},"rerank_days":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["kind","score"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["builder_ranking"]},"saved_ranking_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["weights"],"additionalProperties":false},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":200},"rerank_days":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["copy_engine_sleeve"]},"sleeve":{"default":"a","type":"string","enum":["a","b"]},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":100},"rerank_days":{"default":7,"type":"integer","minimum":1,"maximum":90}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["none"]}},"required":["kind"],"additionalProperties":false}]},"signal":{"default":{},"type":"object","properties":{"on":{"description":"Which trades of the followed wallets are signals: 'buy' (default, its first buy of a token), 'sell' (its first sell of a token it holds), or 'both'.","type":"string","enum":["buy","sell","both"]},"direction":{"description":"'follow' (default): copy the trade (a sell → buy the other outcome of the market). 'against': take the opposite side (a buy of X → buy the other outcome; a sell of X → buy X).","type":"string","enum":["follow","against"]},"consensus":{"type":"object","properties":{"min_wallets":{"type":"integer","minimum":2,"maximum":5},"within_hours":{"type":"number","minimum":0.25,"maximum":72}},"required":["min_wallets","within_hours"],"additionalProperties":false},"rule":{"description":"The signal rule (optional; absent = the history's: taker buy fills of $1+, $5 in 10 minutes, any sell): which fills count and the qualifying window. The amount is market.min_leader_usd.","type":"object","properties":{"role":{"description":"Which of the wallet's BUY fills count: 'taker' (default: its orders that took the book), 'maker' (its resting orders that were hit) or 'any'.","type":"string","enum":["taker","maker","any"]},"min_fill_usd":{"description":"A buy fill below this many dollars does not count (default 1).","type":"number","minimum":0,"maximum":100000},"window_min":{"description":"Minutes from the position's first counted buy in which its counted buys must reach market.min_leader_usd (default 10). The signal is the fill that reaches it.","type":"number","minimum":1,"maximum":1440},"sell_role":{"description":"Which of the wallet's SELL fills count (default 'any').","type":"string","enum":["taker","maker","any"]},"sell_min_fill_usd":{"description":"A sell fill below this many dollars does not count: it neither signals nor ends the position (default 0 = no floor).","type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"additionalProperties":false},"market":{"default":{"phases":["nonsports"],"categories_out":[],"min_price":0.03,"max_price":0.97,"max_days_to_resolution":10,"min_leader_usd":5},"type":"object","properties":{"phases":{"default":["nonsports"],"minItems":1,"type":"array","items":{"type":"string","enum":["nonsports","pregame","inplay"]}},"categories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"categories_out":{"default":[],"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"subcategories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"min_price":{"default":0.03,"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"default":0.97,"type":"number","minimum":0.01,"maximum":0.99},"max_days_to_resolution":{"default":10,"type":"number","minimum":0.04,"maximum":30},"min_days_to_resolution":{"type":"number","minimum":0,"maximum":30},"min_lead_hours":{"type":"number","minimum":0,"maximum":720},"min_leader_usd":{"default":5,"type":"number","minimum":0,"maximum":10000000},"max_leader_usd":{"type":"number","minimum":0,"maximum":100000000}},"additionalProperties":false},"entry":{"default":{"mode":"instant","premium_cents":1,"latency_s":1,"max_age_s":60,"max_wait_min":180,"skip_if_leader_sold":true},"type":"object","properties":{"mode":{"default":"instant","type":"string","enum":["instant","patient"]},"premium_cents":{"default":1,"anyOf":[{"type":"number","minimum":0,"maximum":5},{"type":"string","enum":["any"]}]},"latency_s":{"default":1,"type":"integer","minimum":1,"maximum":60},"max_age_s":{"default":60,"type":"integer","minimum":1,"maximum":3600},"max_wait_min":{"default":180,"type":"integer","minimum":1,"maximum":43200},"skip_if_leader_sold":{"default":true,"type":"boolean"},"limit":{"description":"Strategies that copy no wallet: the most an entry pays. {kind:'ask_plus', cents} = the ask at the decision moment plus cents (0–5); {kind:'price', max} = a fixed price. Absent = at most the ask at the decision moment.","oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["ask_plus"]},"cents":{"type":"number","minimum":0,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["price"]},"max":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["kind","max"],"additionalProperties":false}]},"order":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["market"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["limit"]},"price":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["reference_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["bid_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["ask_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["price"]},"price":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["kind","price"],"additionalProperties":false}]},"tif":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["gtd"]},"minutes":{"type":"integer","minimum":2,"maximum":43200}},"required":["kind","minutes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["until_kickoff"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gtc"]}},"required":["kind"],"additionalProperties":false}]},"post_only":{"default":true,"type":"boolean"},"on_expiry":{"default":"cancel","type":"string","enum":["cancel","take"]},"min_fill_usd":{"default":1,"type":"number","minimum":1,"maximum":1000}},"required":["type","price","tif"],"additionalProperties":false}],"description":"How the entry is sent. Absent or {type:'market'}: a taking order (today). {type:'limit', price, tif, post_only, on_expiry, min_fill_usd}: a BUY that RESTS at its price and fills only when sellers trade through it. price: {kind:'reference_plus', cents} (copies: the leader's price + cents, −30…+5), {kind:'bid_plus'|'ask_plus', cents} (the recorded book at placement), {kind:'price', price}. tif: {kind:'gtd', minutes ≥ 2}, {kind:'until_kickoff'} (pre-game only) or {kind:'gtc'} (until the market ends). post_only (default true) rejects an order that would take on arrival. on_expiry 'cancel' (default) or 'take' (GTD only: the rest takes under premium_cents / entry.limit)."}},"additionalProperties":false},"sizing":{"default":{"clip_usd":10,"bankroll_usd":1000,"one_per_event":false,"builder_fee_bps":0},"type":"object","properties":{"mode":{"description":"'fixed' (default): clip_usd a copy. 'leader_pct': pct % of the followed wallet's dollars, between min_clip_usd and max_clip_usd (required). 'bankroll_pct': pct % of the strategy's current value, between min_clip_usd and max_clip_usd.","type":"string","enum":["fixed","leader_pct","bankroll_pct"]},"clip_usd":{"default":10,"type":"number","minimum":1,"maximum":100000},"pct":{"type":"number","minimum":0.01,"maximum":100},"min_clip_usd":{"type":"number","minimum":1,"maximum":100000},"max_clip_usd":{"type":"number","minimum":1,"maximum":1000000},"leader_basis":{"description":"leader_pct only: 'dollars' (default) = pct % of the leader's fill in dollars; 'shares' = pct % of its shares at the copy's price (the same exposure in shares; differs when the copy buys the other outcome).","type":"string","enum":["dollars","shares"]},"bankroll_usd":{"default":1000,"type":"number","minimum":10,"maximum":100000000},"max_open_usd":{"type":"number","minimum":1,"maximum":100000000},"max_copies_per_day":{"type":"integer","minimum":1,"maximum":10000},"daily_loss_stop_usd":{"type":"number","minimum":1,"maximum":100000000},"one_per_event":{"default":false,"type":"boolean"},"builder_fee_bps":{"default":0,"type":"integer","minimum":0,"maximum":100}},"additionalProperties":false},"exit":{"type":"object","properties":{"mode":{"type":"string","enum":["hold","sell_after","sell_at_close","mirror_leader","rules"]},"hours":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[24]}]},"rules":{"description":"Exit rules: the first to trigger sells the whole copy at the bids; a copy no rule sells is held to resolution. take_profit / stop_loss: cents or pct from the entry price (one of them); time: hours after the copy; at_close: before kickoff (pre-game only); mirror_leader: when the followed wallet undoes the copied trade (sells what it bought, or buys back what it sold).","minItems":1,"maxItems":5,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["take_profit"]},"cents":{"type":"number","minimum":0.5,"maximum":95},"pct":{"type":"number","minimum":1,"maximum":1000}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["stop_loss"]},"cents":{"type":"number","minimum":0.5,"maximum":95},"pct":{"type":"number","minimum":1,"maximum":99}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["time"]},"hours":{"type":"number","minimum":0.25,"maximum":720}},"required":["kind","hours"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["at_close"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["mirror_leader"]},"follow":{"description":"'first_all' (default): the wallet's first sell sells the whole copy. 'proportional': each sell of the wallet sells the same fraction of the copy as it sold of its own position.","type":"string","enum":["first_all","proportional"]},"batch_s":{"description":"proportional: seconds of the wallet’s sells summed into one slice (default 60).","type":"integer","minimum":0,"maximum":3600},"below_min":{"description":"proportional: a slice below the market's minimum order is 'accumulate'd into the next one (default) or the copy 'sell_rest's at once.","type":"string","enum":["accumulate","sell_rest"]}},"required":["kind"],"additionalProperties":false}]}}},"additionalProperties":false},"rules":{"type":"object","properties":{"outcome":{"default":"either","description":"Which outcome of each market the rules watch: 'either' (default), 'yes' or 'no'.","type":"string","enum":["either","yes","no"]},"all":{"minItems":1,"maxItems":8,"type":"array","items":{"oneOf":[{"type":"object","properties":{"feature":{"type":"string","enum":["ask"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["bid"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["spread_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":50}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["ask_depth_3c_usd"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":10000000}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["mid_change_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":-99,"maximum":99},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["abs_mid_change_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":99},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["volume_usd"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":1000000000},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["trades"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"integer","minimum":0,"maximum":1000000},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["days_to_end"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":365}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["hours_since_created"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":100000}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["hours_to_start"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":720}},"required":["feature","op","value"],"additionalProperties":false}]},"description":"Conditions that must ALL hold at the same moment (1 to 8)."},"trigger":{"default":"while_true","description":"'while_true' (default): enter at the first moment every condition holds. 'on_becoming_true': only when they all hold now and did not at the token's previous evaluated moment.","type":"string","enum":["while_true","on_becoming_true"]},"clock_min":{"default":5,"type":"number","enum":[5]}},"required":["all"],"additionalProperties":false}},"required":["wallet_source"],"additionalProperties":false},"template_id":{"type":"string","maxLength":64}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","backtested","paper","promotable","live","archived"]},"template_id":{"type":["string","null"]},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"last_backtest":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"created_at":{"type":"string"}},"required":["id","status","per10","copies","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","status","template_id","spec","created_at","updated_at","last_backtest"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-strategies","summary":"POST /v1/lab/strategies","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/strategies/cleanup":{"get":{"tags":["lab"],"description":"The caller’s EMPTY or DUPLICATE drafts that \"Clean up drafts\" would archive: drafts that never ran (no backtest, no paper run) and are either the blank \"New strategy\" never edited, or the same spec as another of the caller’s strategies (the one that ran, else the oldest, is kept), or the same name as one that ran and never edited since it was created. Needs no plan. 404 `lab_disabled` while LAB_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"strategies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"reason":{"type":"string","enum":["empty","duplicate"]}},"required":["id","name","reason"],"additionalProperties":false}}},"required":["strategies"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-strategies-cleanup","summary":"GET /v1/lab/strategies/cleanup","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["lab"],"description":"Archive the caller’s empty or duplicate drafts (the GET’s list, re-read at once). Archive only, never delete: each comes back with PATCH { archived: false }. Needs no plan. 404 `lab_disabled` while LAB_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"archived":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["archived"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-strategies-cleanup","summary":"POST /v1/lab/strategies/cleanup","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/strategies/{id}":{"get":{"tags":["lab"],"description":"One of the caller’s strategies. 404 when it is not theirs or does not exist. 404 `lab_disabled` while LAB_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","backtested","paper","promotable","live","archived"]},"template_id":{"type":["string","null"]},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"last_backtest":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"created_at":{"type":"string"}},"required":["id","status","per10","copies","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","status","template_id","spec","created_at","updated_at","last_backtest"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-strategies-2","summary":"GET /v1/lab/strategies/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"patch":{"tags":["lab"],"description":"Rename, edit the spec of, archive or unarchive one of the caller’s strategies. An edited spec returns the strategy to draft: its past backtests keep the spec they ran with. 403 `plan_required` (strategy_lab; own rules: Quant and above). 404 `lab_disabled` while LAB_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"spec":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"wallet_source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["static"]},"wallets":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"min_price":{"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["wallet"],"additionalProperties":false}}},"required":["kind","wallets"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["history_ranking"]},"score":{"type":"string","enum":["edge","copier_return","drift_1h","drift_24h","clv","own_return"]},"window_days":{"default":60,"type":"integer","minimum":14,"maximum":120},"min_positions":{"default":20,"type":"integer","minimum":5,"maximum":1000},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":300},"skip_top":{"default":0,"type":"integer","minimum":0,"maximum":300},"score_filter":{"type":"object","properties":{"phases":{"minItems":1,"type":"array","items":{"type":"string","enum":["nonsports","pregame","inplay"]}},"min_price":{"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"type":"number","minimum":0.01,"maximum":0.99},"categories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"categories_out":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"min_lead_hours":{"type":"number","minimum":0,"maximum":720}},"additionalProperties":false},"one_per_operator":{"default":true,"type":"boolean"},"rerank_days":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["kind","score"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["builder_ranking"]},"saved_ranking_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["weights"],"additionalProperties":false},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":200},"rerank_days":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["copy_engine_sleeve"]},"sleeve":{"default":"a","type":"string","enum":["a","b"]},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":100},"rerank_days":{"default":7,"type":"integer","minimum":1,"maximum":90}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["none"]}},"required":["kind"],"additionalProperties":false}]},"signal":{"default":{},"type":"object","properties":{"on":{"description":"Which trades of the followed wallets are signals: 'buy' (default, its first buy of a token), 'sell' (its first sell of a token it holds), or 'both'.","type":"string","enum":["buy","sell","both"]},"direction":{"description":"'follow' (default): copy the trade (a sell → buy the other outcome of the market). 'against': take the opposite side (a buy of X → buy the other outcome; a sell of X → buy X).","type":"string","enum":["follow","against"]},"consensus":{"type":"object","properties":{"min_wallets":{"type":"integer","minimum":2,"maximum":5},"within_hours":{"type":"number","minimum":0.25,"maximum":72}},"required":["min_wallets","within_hours"],"additionalProperties":false},"rule":{"description":"The signal rule (optional; absent = the history's: taker buy fills of $1+, $5 in 10 minutes, any sell): which fills count and the qualifying window. The amount is market.min_leader_usd.","type":"object","properties":{"role":{"description":"Which of the wallet's BUY fills count: 'taker' (default: its orders that took the book), 'maker' (its resting orders that were hit) or 'any'.","type":"string","enum":["taker","maker","any"]},"min_fill_usd":{"description":"A buy fill below this many dollars does not count (default 1).","type":"number","minimum":0,"maximum":100000},"window_min":{"description":"Minutes from the position's first counted buy in which its counted buys must reach market.min_leader_usd (default 10). The signal is the fill that reaches it.","type":"number","minimum":1,"maximum":1440},"sell_role":{"description":"Which of the wallet's SELL fills count (default 'any').","type":"string","enum":["taker","maker","any"]},"sell_min_fill_usd":{"description":"A sell fill below this many dollars does not count: it neither signals nor ends the position (default 0 = no floor).","type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"additionalProperties":false},"market":{"default":{"phases":["nonsports"],"categories_out":[],"min_price":0.03,"max_price":0.97,"max_days_to_resolution":10,"min_leader_usd":5},"type":"object","properties":{"phases":{"default":["nonsports"],"minItems":1,"type":"array","items":{"type":"string","enum":["nonsports","pregame","inplay"]}},"categories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"categories_out":{"default":[],"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"subcategories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"min_price":{"default":0.03,"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"default":0.97,"type":"number","minimum":0.01,"maximum":0.99},"max_days_to_resolution":{"default":10,"type":"number","minimum":0.04,"maximum":30},"min_days_to_resolution":{"type":"number","minimum":0,"maximum":30},"min_lead_hours":{"type":"number","minimum":0,"maximum":720},"min_leader_usd":{"default":5,"type":"number","minimum":0,"maximum":10000000},"max_leader_usd":{"type":"number","minimum":0,"maximum":100000000}},"additionalProperties":false},"entry":{"default":{"mode":"instant","premium_cents":1,"latency_s":1,"max_age_s":60,"max_wait_min":180,"skip_if_leader_sold":true},"type":"object","properties":{"mode":{"default":"instant","type":"string","enum":["instant","patient"]},"premium_cents":{"default":1,"anyOf":[{"type":"number","minimum":0,"maximum":5},{"type":"string","enum":["any"]}]},"latency_s":{"default":1,"type":"integer","minimum":1,"maximum":60},"max_age_s":{"default":60,"type":"integer","minimum":1,"maximum":3600},"max_wait_min":{"default":180,"type":"integer","minimum":1,"maximum":43200},"skip_if_leader_sold":{"default":true,"type":"boolean"},"limit":{"description":"Strategies that copy no wallet: the most an entry pays. {kind:'ask_plus', cents} = the ask at the decision moment plus cents (0–5); {kind:'price', max} = a fixed price. Absent = at most the ask at the decision moment.","oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["ask_plus"]},"cents":{"type":"number","minimum":0,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["price"]},"max":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["kind","max"],"additionalProperties":false}]},"order":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["market"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["limit"]},"price":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["reference_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["bid_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["ask_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["price"]},"price":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["kind","price"],"additionalProperties":false}]},"tif":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["gtd"]},"minutes":{"type":"integer","minimum":2,"maximum":43200}},"required":["kind","minutes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["until_kickoff"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gtc"]}},"required":["kind"],"additionalProperties":false}]},"post_only":{"default":true,"type":"boolean"},"on_expiry":{"default":"cancel","type":"string","enum":["cancel","take"]},"min_fill_usd":{"default":1,"type":"number","minimum":1,"maximum":1000}},"required":["type","price","tif"],"additionalProperties":false}],"description":"How the entry is sent. Absent or {type:'market'}: a taking order (today). {type:'limit', price, tif, post_only, on_expiry, min_fill_usd}: a BUY that RESTS at its price and fills only when sellers trade through it. price: {kind:'reference_plus', cents} (copies: the leader's price + cents, −30…+5), {kind:'bid_plus'|'ask_plus', cents} (the recorded book at placement), {kind:'price', price}. tif: {kind:'gtd', minutes ≥ 2}, {kind:'until_kickoff'} (pre-game only) or {kind:'gtc'} (until the market ends). post_only (default true) rejects an order that would take on arrival. on_expiry 'cancel' (default) or 'take' (GTD only: the rest takes under premium_cents / entry.limit)."}},"additionalProperties":false},"sizing":{"default":{"clip_usd":10,"bankroll_usd":1000,"one_per_event":false,"builder_fee_bps":0},"type":"object","properties":{"mode":{"description":"'fixed' (default): clip_usd a copy. 'leader_pct': pct % of the followed wallet's dollars, between min_clip_usd and max_clip_usd (required). 'bankroll_pct': pct % of the strategy's current value, between min_clip_usd and max_clip_usd.","type":"string","enum":["fixed","leader_pct","bankroll_pct"]},"clip_usd":{"default":10,"type":"number","minimum":1,"maximum":100000},"pct":{"type":"number","minimum":0.01,"maximum":100},"min_clip_usd":{"type":"number","minimum":1,"maximum":100000},"max_clip_usd":{"type":"number","minimum":1,"maximum":1000000},"leader_basis":{"description":"leader_pct only: 'dollars' (default) = pct % of the leader's fill in dollars; 'shares' = pct % of its shares at the copy's price (the same exposure in shares; differs when the copy buys the other outcome).","type":"string","enum":["dollars","shares"]},"bankroll_usd":{"default":1000,"type":"number","minimum":10,"maximum":100000000},"max_open_usd":{"type":"number","minimum":1,"maximum":100000000},"max_copies_per_day":{"type":"integer","minimum":1,"maximum":10000},"daily_loss_stop_usd":{"type":"number","minimum":1,"maximum":100000000},"one_per_event":{"default":false,"type":"boolean"},"builder_fee_bps":{"default":0,"type":"integer","minimum":0,"maximum":100}},"additionalProperties":false},"exit":{"type":"object","properties":{"mode":{"type":"string","enum":["hold","sell_after","sell_at_close","mirror_leader","rules"]},"hours":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[24]}]},"rules":{"description":"Exit rules: the first to trigger sells the whole copy at the bids; a copy no rule sells is held to resolution. take_profit / stop_loss: cents or pct from the entry price (one of them); time: hours after the copy; at_close: before kickoff (pre-game only); mirror_leader: when the followed wallet undoes the copied trade (sells what it bought, or buys back what it sold).","minItems":1,"maxItems":5,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["take_profit"]},"cents":{"type":"number","minimum":0.5,"maximum":95},"pct":{"type":"number","minimum":1,"maximum":1000}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["stop_loss"]},"cents":{"type":"number","minimum":0.5,"maximum":95},"pct":{"type":"number","minimum":1,"maximum":99}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["time"]},"hours":{"type":"number","minimum":0.25,"maximum":720}},"required":["kind","hours"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["at_close"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["mirror_leader"]},"follow":{"description":"'first_all' (default): the wallet's first sell sells the whole copy. 'proportional': each sell of the wallet sells the same fraction of the copy as it sold of its own position.","type":"string","enum":["first_all","proportional"]},"batch_s":{"description":"proportional: seconds of the wallet’s sells summed into one slice (default 60).","type":"integer","minimum":0,"maximum":3600},"below_min":{"description":"proportional: a slice below the market's minimum order is 'accumulate'd into the next one (default) or the copy 'sell_rest's at once.","type":"string","enum":["accumulate","sell_rest"]}},"required":["kind"],"additionalProperties":false}]}}},"additionalProperties":false},"rules":{"type":"object","properties":{"outcome":{"default":"either","description":"Which outcome of each market the rules watch: 'either' (default), 'yes' or 'no'.","type":"string","enum":["either","yes","no"]},"all":{"minItems":1,"maxItems":8,"type":"array","items":{"oneOf":[{"type":"object","properties":{"feature":{"type":"string","enum":["ask"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["bid"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["spread_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":50}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["ask_depth_3c_usd"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":10000000}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["mid_change_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":-99,"maximum":99},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["abs_mid_change_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":99},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["volume_usd"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":1000000000},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["trades"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"integer","minimum":0,"maximum":1000000},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["days_to_end"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":365}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["hours_since_created"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":100000}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["hours_to_start"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":720}},"required":["feature","op","value"],"additionalProperties":false}]},"description":"Conditions that must ALL hold at the same moment (1 to 8)."},"trigger":{"default":"while_true","description":"'while_true' (default): enter at the first moment every condition holds. 'on_becoming_true': only when they all hold now and did not at the token's previous evaluated moment.","type":"string","enum":["while_true","on_becoming_true"]},"clock_min":{"default":5,"type":"number","enum":[5]}},"required":["all"],"additionalProperties":false}},"required":["wallet_source"],"additionalProperties":false},"archived":{"type":"boolean"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","backtested","paper","promotable","live","archived"]},"template_id":{"type":["string","null"]},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"last_backtest":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"created_at":{"type":"string"}},"required":["id","status","per10","copies","created_at"],"additionalProperties":false},{"type":"null"}]}},"required":["id","name","status","template_id","spec","created_at","updated_at","last_backtest"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-lab-strategies","summary":"PATCH /v1/lab/strategies/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["lab"],"description":"Delete one of the caller’s strategies and its paper runs. Its past backtests are kept (unlinked) in the caller’s history. Needs no plan. 404 `lab_disabled` while LAB_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-lab-strategies","summary":"DELETE /v1/lab/strategies/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/backtests":{"post":{"tags":["lab"],"description":"$124","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"strategy_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"spec":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"wallet_source":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["static"]},"wallets":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"min_price":{"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["wallet"],"additionalProperties":false}}},"required":["kind","wallets"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["history_ranking"]},"score":{"type":"string","enum":["edge","copier_return","drift_1h","drift_24h","clv","own_return"]},"window_days":{"default":60,"type":"integer","minimum":14,"maximum":120},"min_positions":{"default":20,"type":"integer","minimum":5,"maximum":1000},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":300},"skip_top":{"default":0,"type":"integer","minimum":0,"maximum":300},"score_filter":{"type":"object","properties":{"phases":{"minItems":1,"type":"array","items":{"type":"string","enum":["nonsports","pregame","inplay"]}},"min_price":{"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"type":"number","minimum":0.01,"maximum":0.99},"categories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"categories_out":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"min_lead_hours":{"type":"number","minimum":0,"maximum":720}},"additionalProperties":false},"one_per_operator":{"default":true,"type":"boolean"},"rerank_days":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["kind","score"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["builder_ranking"]},"saved_ranking_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"config":{"type":"object","properties":{"version":{"default":1,"type":"number","enum":[1]},"weights":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]}},"required":["weights"],"additionalProperties":false},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":200},"rerank_days":{"default":30,"type":"integer","minimum":1,"maximum":90}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["copy_engine_sleeve"]},"sleeve":{"default":"a","type":"string","enum":["a","b"]},"top_n":{"default":25,"type":"integer","minimum":1,"maximum":100},"rerank_days":{"default":7,"type":"integer","minimum":1,"maximum":90}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["none"]}},"required":["kind"],"additionalProperties":false}]},"signal":{"default":{},"type":"object","properties":{"on":{"description":"Which trades of the followed wallets are signals: 'buy' (default, its first buy of a token), 'sell' (its first sell of a token it holds), or 'both'.","type":"string","enum":["buy","sell","both"]},"direction":{"description":"'follow' (default): copy the trade (a sell → buy the other outcome of the market). 'against': take the opposite side (a buy of X → buy the other outcome; a sell of X → buy X).","type":"string","enum":["follow","against"]},"consensus":{"type":"object","properties":{"min_wallets":{"type":"integer","minimum":2,"maximum":5},"within_hours":{"type":"number","minimum":0.25,"maximum":72}},"required":["min_wallets","within_hours"],"additionalProperties":false},"rule":{"description":"The signal rule (optional; absent = the history's: taker buy fills of $1+, $5 in 10 minutes, any sell): which fills count and the qualifying window. The amount is market.min_leader_usd.","type":"object","properties":{"role":{"description":"Which of the wallet's BUY fills count: 'taker' (default: its orders that took the book), 'maker' (its resting orders that were hit) or 'any'.","type":"string","enum":["taker","maker","any"]},"min_fill_usd":{"description":"A buy fill below this many dollars does not count (default 1).","type":"number","minimum":0,"maximum":100000},"window_min":{"description":"Minutes from the position's first counted buy in which its counted buys must reach market.min_leader_usd (default 10). The signal is the fill that reaches it.","type":"number","minimum":1,"maximum":1440},"sell_role":{"description":"Which of the wallet's SELL fills count (default 'any').","type":"string","enum":["taker","maker","any"]},"sell_min_fill_usd":{"description":"A sell fill below this many dollars does not count: it neither signals nor ends the position (default 0 = no floor).","type":"number","minimum":0,"maximum":100000}},"additionalProperties":false}},"additionalProperties":false},"market":{"default":{"phases":["nonsports"],"categories_out":[],"min_price":0.03,"max_price":0.97,"max_days_to_resolution":10,"min_leader_usd":5},"type":"object","properties":{"phases":{"default":["nonsports"],"minItems":1,"type":"array","items":{"type":"string","enum":["nonsports","pregame","inplay"]}},"categories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"categories_out":{"default":[],"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"subcategories_in":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"min_price":{"default":0.03,"type":"number","minimum":0.01,"maximum":0.99},"max_price":{"default":0.97,"type":"number","minimum":0.01,"maximum":0.99},"max_days_to_resolution":{"default":10,"type":"number","minimum":0.04,"maximum":30},"min_days_to_resolution":{"type":"number","minimum":0,"maximum":30},"min_lead_hours":{"type":"number","minimum":0,"maximum":720},"min_leader_usd":{"default":5,"type":"number","minimum":0,"maximum":10000000},"max_leader_usd":{"type":"number","minimum":0,"maximum":100000000}},"additionalProperties":false},"entry":{"default":{"mode":"instant","premium_cents":1,"latency_s":1,"max_age_s":60,"max_wait_min":180,"skip_if_leader_sold":true},"type":"object","properties":{"mode":{"default":"instant","type":"string","enum":["instant","patient"]},"premium_cents":{"default":1,"anyOf":[{"type":"number","minimum":0,"maximum":5},{"type":"string","enum":["any"]}]},"latency_s":{"default":1,"type":"integer","minimum":1,"maximum":60},"max_age_s":{"default":60,"type":"integer","minimum":1,"maximum":3600},"max_wait_min":{"default":180,"type":"integer","minimum":1,"maximum":43200},"skip_if_leader_sold":{"default":true,"type":"boolean"},"limit":{"description":"Strategies that copy no wallet: the most an entry pays. {kind:'ask_plus', cents} = the ask at the decision moment plus cents (0–5); {kind:'price', max} = a fixed price. Absent = at most the ask at the decision moment.","oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["ask_plus"]},"cents":{"type":"number","minimum":0,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["price"]},"max":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["kind","max"],"additionalProperties":false}]},"order":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["market"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["limit"]},"price":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["reference_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["bid_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["ask_plus"]},"cents":{"type":"number","minimum":-30,"maximum":5}},"required":["kind","cents"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["price"]},"price":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["kind","price"],"additionalProperties":false}]},"tif":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["gtd"]},"minutes":{"type":"integer","minimum":2,"maximum":43200}},"required":["kind","minutes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["until_kickoff"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["gtc"]}},"required":["kind"],"additionalProperties":false}]},"post_only":{"default":true,"type":"boolean"},"on_expiry":{"default":"cancel","type":"string","enum":["cancel","take"]},"min_fill_usd":{"default":1,"type":"number","minimum":1,"maximum":1000}},"required":["type","price","tif"],"additionalProperties":false}],"description":"How the entry is sent. Absent or {type:'market'}: a taking order (today). {type:'limit', price, tif, post_only, on_expiry, min_fill_usd}: a BUY that RESTS at its price and fills only when sellers trade through it. price: {kind:'reference_plus', cents} (copies: the leader's price + cents, −30…+5), {kind:'bid_plus'|'ask_plus', cents} (the recorded book at placement), {kind:'price', price}. tif: {kind:'gtd', minutes ≥ 2}, {kind:'until_kickoff'} (pre-game only) or {kind:'gtc'} (until the market ends). post_only (default true) rejects an order that would take on arrival. on_expiry 'cancel' (default) or 'take' (GTD only: the rest takes under premium_cents / entry.limit)."}},"additionalProperties":false},"sizing":{"default":{"clip_usd":10,"bankroll_usd":1000,"one_per_event":false,"builder_fee_bps":0},"type":"object","properties":{"mode":{"description":"'fixed' (default): clip_usd a copy. 'leader_pct': pct % of the followed wallet's dollars, between min_clip_usd and max_clip_usd (required). 'bankroll_pct': pct % of the strategy's current value, between min_clip_usd and max_clip_usd.","type":"string","enum":["fixed","leader_pct","bankroll_pct"]},"clip_usd":{"default":10,"type":"number","minimum":1,"maximum":100000},"pct":{"type":"number","minimum":0.01,"maximum":100},"min_clip_usd":{"type":"number","minimum":1,"maximum":100000},"max_clip_usd":{"type":"number","minimum":1,"maximum":1000000},"leader_basis":{"description":"leader_pct only: 'dollars' (default) = pct % of the leader's fill in dollars; 'shares' = pct % of its shares at the copy's price (the same exposure in shares; differs when the copy buys the other outcome).","type":"string","enum":["dollars","shares"]},"bankroll_usd":{"default":1000,"type":"number","minimum":10,"maximum":100000000},"max_open_usd":{"type":"number","minimum":1,"maximum":100000000},"max_copies_per_day":{"type":"integer","minimum":1,"maximum":10000},"daily_loss_stop_usd":{"type":"number","minimum":1,"maximum":100000000},"one_per_event":{"default":false,"type":"boolean"},"builder_fee_bps":{"default":0,"type":"integer","minimum":0,"maximum":100}},"additionalProperties":false},"exit":{"type":"object","properties":{"mode":{"type":"string","enum":["hold","sell_after","sell_at_close","mirror_leader","rules"]},"hours":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[24]}]},"rules":{"description":"Exit rules: the first to trigger sells the whole copy at the bids; a copy no rule sells is held to resolution. take_profit / stop_loss: cents or pct from the entry price (one of them); time: hours after the copy; at_close: before kickoff (pre-game only); mirror_leader: when the followed wallet undoes the copied trade (sells what it bought, or buys back what it sold).","minItems":1,"maxItems":5,"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["take_profit"]},"cents":{"type":"number","minimum":0.5,"maximum":95},"pct":{"type":"number","minimum":1,"maximum":1000}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["stop_loss"]},"cents":{"type":"number","minimum":0.5,"maximum":95},"pct":{"type":"number","minimum":1,"maximum":99}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["time"]},"hours":{"type":"number","minimum":0.25,"maximum":720}},"required":["kind","hours"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["at_close"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["mirror_leader"]},"follow":{"description":"'first_all' (default): the wallet's first sell sells the whole copy. 'proportional': each sell of the wallet sells the same fraction of the copy as it sold of its own position.","type":"string","enum":["first_all","proportional"]},"batch_s":{"description":"proportional: seconds of the wallet’s sells summed into one slice (default 60).","type":"integer","minimum":0,"maximum":3600},"below_min":{"description":"proportional: a slice below the market's minimum order is 'accumulate'd into the next one (default) or the copy 'sell_rest's at once.","type":"string","enum":["accumulate","sell_rest"]}},"required":["kind"],"additionalProperties":false}]}}},"additionalProperties":false},"rules":{"type":"object","properties":{"outcome":{"default":"either","description":"Which outcome of each market the rules watch: 'either' (default), 'yes' or 'no'.","type":"string","enum":["either","yes","no"]},"all":{"minItems":1,"maxItems":8,"type":"array","items":{"oneOf":[{"type":"object","properties":{"feature":{"type":"string","enum":["ask"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["bid"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0.01,"maximum":0.99}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["spread_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":50}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["ask_depth_3c_usd"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":10000000}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["mid_change_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":-99,"maximum":99},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["abs_mid_change_c"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":99},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["volume_usd"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":1000000000},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["trades"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"integer","minimum":0,"maximum":1000000},"window_h":{"type":"number","minimum":0.25,"maximum":72,"description":"the window in hours (0.25 to 72, in quarter hours)"}},"required":["feature","op","value","window_h"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["days_to_end"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":365}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["hours_since_created"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":100000}},"required":["feature","op","value"],"additionalProperties":false},{"type":"object","properties":{"feature":{"type":"string","enum":["hours_to_start"]},"op":{"type":"string","enum":[">=","<="],"description":"'>=' (at least) or '<=' (at most)"},"value":{"type":"number","minimum":0,"maximum":720}},"required":["feature","op","value"],"additionalProperties":false}]},"description":"Conditions that must ALL hold at the same moment (1 to 8)."},"trigger":{"default":"while_true","description":"'while_true' (default): enter at the first moment every condition holds. 'on_becoming_true': only when they all hold now and did not at the token's previous evaluated moment.","type":"string","enum":["while_true","on_becoming_true"]},"clock_min":{"default":5,"type":"number","enum":[5]}},"required":["all"],"additionalProperties":false}},"required":["wallet_source"],"additionalProperties":false},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"cuts":{"maxItems":60,"type":"array","items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"purpose":{"type":"string","enum":["user","research"]},"final_test":{"type":"boolean"}},"required":["from","to"],"additionalProperties":false}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":["string","null"]},"status":{"type":"string","enum":["queued","running","done","failed"]},"error":{"type":["string","null"]},"from":{"type":"string"},"to":{"type":"string"},"source":{"type":"string"},"created_at":{"type":"string"},"finished_at":{"type":["string","null"]},"duration_ms":{"type":["number","null"]},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"purpose":{"type":"string","enum":["user","research"]},"final_test":{"type":"boolean"}},"required":["id","strategy_id","status","error","from","to","source","created_at","finished_at","duration_ms","per10","copies","purpose","final_test"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-backtests","summary":"POST /v1/lab/backtests","security":[{"apiKey":[]},{"sessionCookie":[]}]},"get":{"tags":["lab"],"description":"The caller’s backtests, newest first (optionally one strategy’s), without their reports. Research runs (purpose `research`) are left out unless include_research=true; research_hidden counts them. 404 `lab_disabled` while LAB_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"strategy_id","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["0","1","true","false"]},"in":"query","name":"include_research","required":false,"description":"true / false / 1 / 0"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"backtests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":["string","null"]},"status":{"type":"string","enum":["queued","running","done","failed"]},"error":{"type":["string","null"]},"from":{"type":"string"},"to":{"type":"string"},"source":{"type":"string"},"created_at":{"type":"string"},"finished_at":{"type":["string","null"]},"duration_ms":{"type":["number","null"]},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"purpose":{"type":"string","enum":["user","research"]},"final_test":{"type":"boolean"}},"required":["id","strategy_id","status","error","from","to","source","created_at","finished_at","duration_ms","per10","copies","purpose","final_test"],"additionalProperties":false}},"research_hidden":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["backtests","research_hidden"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-backtests","summary":"GET /v1/lab/backtests","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/backtests/{id}":{"patch":{"tags":["lab"],"description":"Re-label one of the caller’s backtests: purpose `research` keeps it out of the run list by default, `user` brings it back. Nothing else about a run can change (its spec and report are frozen). 404 for another account’s run; 404 `lab_disabled` while LAB_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"type":"string","enum":["user","research"]}},"required":["purpose"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":["string","null"]},"status":{"type":"string","enum":["queued","running","done","failed"]},"error":{"type":["string","null"]},"from":{"type":"string"},"to":{"type":"string"},"source":{"type":"string"},"created_at":{"type":"string"},"finished_at":{"type":["string","null"]},"duration_ms":{"type":["number","null"]},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"purpose":{"type":"string","enum":["user","research"]},"final_test":{"type":"boolean"}},"required":["id","strategy_id","status","error","from","to","source","created_at","finished_at","duration_ms","per10","copies","purpose","final_test"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-lab-backtests","summary":"PATCH /v1/lab/backtests/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"get":{"tags":["lab"],"description":"One of the caller’s backtests: its status, the frozen spec and, when done, the report (SIMULATED; per period, pooled, the no-selection control, without the best wallet / best 3 days, the bankroll, capacity, the funnel, per wallet and per day, the fill model and its measured optimism), and strategy_final_test: the strategy’s final test when one was run (once per strategy). 404 `lab_disabled` while LAB_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":["string","null"]},"status":{"type":"string","enum":["queued","running","done","failed"]},"error":{"type":["string","null"]},"from":{"type":"string"},"to":{"type":"string"},"source":{"type":"string"},"created_at":{"type":"string"},"finished_at":{"type":["string","null"]},"duration_ms":{"type":["number","null"]},"per10":{"type":["number","null"]},"copies":{"type":["number","null"]},"purpose":{"type":"string","enum":["user","research"]},"final_test":{"type":"boolean"},"spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"report":{"anyOf":[{"type":"object","properties":{"version":{"type":"number","enum":[1]},"simulated":{"type":"boolean","enum":[true]},"fill_model":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"known_optimism":{"type":"array","items":{"type":"string"}}},"required":["name","description","known_optimism"],"additionalProperties":false},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"trades_through":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"history_through":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"history_from":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"periods":{"type":"array","items":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"wallets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"in_sample":{"type":"boolean"},"note":{"type":["string","null"]}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","from","to","wallets","in_sample","note"],"additionalProperties":false}},"pooled":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"days_up_share":{"type":["number","null"]},"fees_usd_per10":{"type":"number"},"builder_fees_usd_per10":{"type":"number"},"median_entry_vs_leader_cents":{"type":["number","null"]}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","days_up_share","fees_usd_per10","builder_fees_usd_per10","median_entry_vs_leader_cents"],"additionalProperties":false},"control":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"description":{"type":"string"}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","description"],"additionalProperties":false},"robustness":{"type":"object","properties":{"without_best_wallet":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"wallet":{"type":["string","null"]}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","wallet"],"additionalProperties":false},"without_best_3_days":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"days":{"type":"array","items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","days"],"additionalProperties":false},"without_best_market":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"event":{"type":["string","null"]}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","event"],"additionalProperties":false}},"required":["without_best_wallet","without_best_3_days"],"additionalProperties":false},"bankroll":{"type":"object","properties":{"start_usd":{"type":"number"},"end_usd":{"type":"number"},"return_pct":{"type":"number"},"max_drawdown_pct":{"type":"number"},"copies_taken":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"skipped_cash":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"skipped_caps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"weekly":{"type":"array","items":{"type":"object","properties":{"week":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"value_usd":{"type":"number"}},"required":["week","value_usd"],"additionalProperties":false}}},"required":["start_usd","end_usd","return_pct","max_drawdown_pct","copies_taken","skipped_cash","skipped_caps","weekly"],"additionalProperties":false},"capacity":{"type":"object","properties":{"median_tradable_usd":{"type":["number","null"]},"p25_tradable_usd":{"type":["number","null"]},"usd_per_day_at_clip":{"type":["number","null"]}},"required":["median_tradable_usd","p25_tradable_usd","usd_per_day_at_clip"],"additionalProperties":false},"funnel":{"type":"object","properties":{"signals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"no_fill":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"leader_sold":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"duplicate_token":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"moments":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"eligible_moments":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"no_book":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"no_depth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"above_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["signals","eligible","no_fill","leader_sold","duplicate_token","copies"],"additionalProperties":false},"per_wallet":{"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string"},"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"win_rate":{"type":["number","null"]}},"required":["wallet","copies","per10","win_rate"],"additionalProperties":false}},"daily":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pnl_usd_per10":{"type":"number"}},"required":["day","copies","pnl_usd_per10"],"additionalProperties":false}},"exits":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"string"}},"sold":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"resolution":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"no_price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"basis":{"type":"object","properties":{"books":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prints":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["books","prints"],"additionalProperties":false},"partial":{"type":"object","properties":{"legs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"copies_partly_held":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"below_min_slices":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"min_order_shares":{"type":"number"}},"required":["legs","copies_partly_held","below_min_slices","min_order_shares"],"additionalProperties":false}},"required":["rules","sold","resolution","no_price","basis"],"additionalProperties":false},"signals":{"type":"object","properties":{"on":{"type":"string","enum":["buy","sell","both"]},"direction":{"type":"string","enum":["follow","against"]},"by_kind":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day"],"additionalProperties":false}},"control_sample":{"anyOf":[{"type":"object","properties":{"kept":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"of":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["kept","of"],"additionalProperties":false},{"type":"null"}]},"both_pairs":{"type":"object","properties":{"pairs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]}},"required":["pairs","per10"],"additionalProperties":false}},"required":["on","direction","by_kind","control_sample"],"additionalProperties":false},"late_entry":{"type":"object","properties":{"strategy":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"moved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dropped":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unread":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows","moved","dropped","unread"],"additionalProperties":false},"control":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"moved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dropped":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unread":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows","moved","dropped","unread"],"additionalProperties":false}},"required":["strategy","control"],"additionalProperties":false},"signal_rule":{"type":"object","properties":{"role":{"type":"string","enum":["taker","maker","any"]},"min_fill_usd":{"type":"number"},"window_min":{"type":"number"},"amount_usd":{"type":"number"},"sell_role":{"type":"string","enum":["taker","maker","any"]},"sell_min_fill_usd":{"type":"number"},"source":{"type":"string","enum":["history","fills"]}},"required":["role","min_fill_usd","window_min","amount_usd","sell_role","sell_min_fill_usd","source"],"additionalProperties":false},"baseline":{"type":"object","properties":{"kind":{"type":"string","enum":["price_matched"]},"description":{"type":"string"},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"entries_matched":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"entries_unmatched":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pool":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per_entry":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"diff_per10":{"type":["number","null"]},"diff_t":{"type":["number","null"]},"universe":{"type":"object","properties":{"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"total_usd_per10":{"type":"number"},"copies_per_day":{"type":["number","null"]},"description":{"type":"string"},"sample":{"anyOf":[{"type":"object","properties":{"kept":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"of":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["kept","of"],"additionalProperties":false},{"type":"null"}]}},"required":["copies","per10","t","win_rate","total_usd_per10","copies_per_day","description","sample"],"additionalProperties":false}},"required":["kind","description","per10","t","entries_matched","entries_unmatched","pool","per_entry","diff_per10","diff_t","universe"],"additionalProperties":false},"rules":{"type":"object","properties":{"events":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"t_clustered":{"type":["number","null"]},"variants":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expected_best_t":{"type":["number","null"]},"universe_hash":{"type":"string"},"features_hash":{"type":"string"},"holdout":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sealed":{"type":"boolean"},"final_test":{"type":"boolean"}},"required":["from","to","sealed","final_test"],"additionalProperties":false},"words":{"type":"string"}},"required":["events","t_clustered","variants","expected_best_t","universe_hash","features_hash","holdout","words"],"additionalProperties":false},"limit":{"type":"object","properties":{"model":{"type":"string","enum":["maker_through_v1"]},"orders":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"no_book":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rejected_post_only":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"crossed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"filled_full":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"filled_partial":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"below_min":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ended":{"type":"object","properties":{"expired":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kickoff":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"leader_sold":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"market_end":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["expired","kickoff","leader_sold","market_end"],"additionalProperties":false},"taken_at_expiry":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fill_share":{"type":["number","null"]},"maker_share":{"type":["number","null"]},"median_minutes_to_fill":{"type":["number","null"]},"filled_per10":{"type":["number","null"]},"missed_per10":{"type":["number","null"]},"missed_priced":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rebates":{"type":"string","enum":["not_counted"]},"words":{"type":"string"}},"required":["model","orders","no_book","rejected_post_only","crossed","filled_full","filled_partial","below_min","missed","ended","taken_at_expiry","fill_share","maker_share","median_minutes_to_fill","filled_per10","missed_per10","missed_priced","rebates","words"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["version","simulated","fill_model","from","to","trades_through","history_through","periods","pooled","control","robustness","bankroll","capacity","funnel","per_wallet","daily","warnings"],"additionalProperties":false},{"type":"null"}]},"strategy_final_test":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string","enum":["queued","running","done","failed"]}},"required":["id","status"],"additionalProperties":false},{"type":"null"}]}},"required":["id","strategy_id","status","error","from","to","source","created_at","finished_at","duration_ms","per10","copies","purpose","final_test","spec","report","strategy_final_test"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-backtests-2","summary":"GET /v1/lab/backtests/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/strategies/{id}/paper":{"post":{"tags":["lab"],"description":"Start paper trading one of the caller’s strategies: from now on, every signal of its wallets is scored against the real order book (no orders, no keys). The spec and a Builder source’s config are frozen into the run; wallets are seated as-of today and re-seated every rerank_days. One active run per strategy (409 `paper_run_active`); a strategy that copies no wallet has its rules evaluated on the live order-book stream with the backtest’s own decisions, once per market, each entry filled on the live book (400 `rules_paper_not_yet` while LAB_RULES_PAPER_ENABLED is off); 400 `limit_orders_paper_not_yet` for a strategy whose entry rests a limit order (backtests only, for now); 400 `lab_paper_runs_max` at the plan’s limit; 403 `plan_required` (paper_trading). 404 `lab_paper_disabled` while LAB_PAPER_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":"string"},"status":{"type":"string","enum":["active","stopped"]},"wallets":{"type":"array","items":{"type":"string"}},"wallets_refreshed_at":{"type":["string","null"]},"started_at":{"type":"string"},"stopped_at":{"type":["string","null"]},"graded_at":{"type":["string","null"]},"resolved_copies":{"type":"number"},"promotable":{"type":"boolean"},"stats":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"known_issues":{"type":"array","items":{"type":"string"}},"kind":{"type":"string","enum":["copy","rules"]}},"required":["id","strategy_id","status","wallets","wallets_refreshed_at","started_at","stopped_at","graded_at","resolved_copies","promotable","stats","notes","known_issues","kind"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-strategies-paper","summary":"POST /v1/lab/strategies/{id}/paper","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/paper-runs/{id}/stop":{"post":{"tags":["lab"],"description":"Stop one of the caller’s paper runs. Its copies and stats are kept; open copies still settle. Needs no plan. 404 `lab_paper_disabled` while LAB_PAPER_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":"string"},"status":{"type":"string","enum":["active","stopped"]},"wallets":{"type":"array","items":{"type":"string"}},"wallets_refreshed_at":{"type":["string","null"]},"started_at":{"type":"string"},"stopped_at":{"type":["string","null"]},"graded_at":{"type":["string","null"]},"resolved_copies":{"type":"number"},"promotable":{"type":"boolean"},"stats":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"known_issues":{"type":"array","items":{"type":"string"}},"kind":{"type":"string","enum":["copy","rules"]}},"required":["id","strategy_id","status","wallets","wallets_refreshed_at","started_at","stopped_at","graded_at","resolved_copies","promotable","stats","notes","known_issues","kind"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-paper-runs-stop","summary":"POST /v1/lab/paper-runs/{id}/stop","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/paper-runs":{"get":{"tags":["lab"],"description":"The caller’s paper runs, newest first, with the grader’s stats (copies, resolved, P&L per $10, entry against the leader, availability, the paper gate). 404 `lab_paper_disabled` while LAB_PAPER_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"query","name":"strategy_id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"paper_runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":"string"},"status":{"type":"string","enum":["active","stopped"]},"wallets":{"type":"array","items":{"type":"string"}},"wallets_refreshed_at":{"type":["string","null"]},"started_at":{"type":"string"},"stopped_at":{"type":["string","null"]},"graded_at":{"type":["string","null"]},"resolved_copies":{"type":"number"},"promotable":{"type":"boolean"},"stats":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"known_issues":{"type":"array","items":{"type":"string"}},"kind":{"type":"string","enum":["copy","rules"]}},"required":["id","strategy_id","status","wallets","wallets_refreshed_at","started_at","stopped_at","graded_at","resolved_copies","promotable","stats","notes","known_issues","kind"],"additionalProperties":false}}},"required":["paper_runs"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-paper-runs","summary":"GET /v1/lab/paper-runs","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/paper-runs/{id}":{"get":{"tags":["lab"],"description":"One of the caller’s paper runs with its copy records, newest first (optionally one outcome): the leader’s price and dollars, what the book gave (entry, delay, dollars available at the limit), the settlement and P&L. 404 `lab_paper_disabled` while LAB_PAPER_ENABLED is off.","parameters":[{"schema":{"type":"string","enum":["copied","no_fill","leader_sold","capped","skipped"]},"in":"query","name":"outcome","required":false},{"schema":{"default":100,"type":"integer","minimum":1,"maximum":500},"in":"query","name":"limit","required":false},{"schema":{"default":0,"type":"integer","minimum":0,"maximum":100000},"in":"query","name":"offset","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":"string"},"status":{"type":"string","enum":["active","stopped"]},"wallets":{"type":"array","items":{"type":"string"}},"wallets_refreshed_at":{"type":["string","null"]},"started_at":{"type":"string"},"stopped_at":{"type":["string","null"]},"graded_at":{"type":["string","null"]},"resolved_copies":{"type":"number"},"promotable":{"type":"boolean"},"stats":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"notes":{"type":"array","items":{"type":"string"}},"known_issues":{"type":"array","items":{"type":"string"}},"kind":{"type":"string","enum":["copy","rules"]},"copies":{"type":"array","items":{"type":"object","properties":{"wallet":{"type":"string"},"token_id":{"type":"string"},"condition_id":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"signal_at":{"type":"string"},"leader_price":{"type":"number"},"leader_usd":{"type":"number"},"outcome":{"type":"string"},"reason":{"type":["string","null"]},"entry_at":{"type":["string","null"]},"entry_price":{"type":["number","null"]},"entry_delay_s":{"type":["number","null"]},"clip_usd":{"type":["number","null"]},"tradable_usd":{"type":["number","null"]},"exit_at":{"type":["string","null"]},"exit_price":{"type":["number","null"]},"won":{"type":["number","null"]},"pnl_usd":{"type":["number","null"]},"settled_at":{"type":["string","null"]},"signal":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string"},"side":{"type":"string","enum":["buy","sell"]},"token":{"type":"string"},"price":{"type":"number"},"ref":{"type":["number","null"]}},"required":["kind","side","token","price","ref"],"additionalProperties":false},{"type":"null"}]},"signal_kind":{"type":"string","enum":["wallet","rule"]},"rule":{"anyOf":[{"type":"object","properties":{"moment":{"type":"string"},"ask":{"type":"number"},"bid":{"type":"number"},"phase":{"type":"string"},"outcome":{"anyOf":[{"type":"string","enum":["yes","no"]},{"type":"null"}]},"days_to_end":{"type":["number","null"]},"conditions":{"type":"array","items":{"type":"object","properties":{"feature":{"type":"string"},"op":{"type":"string"},"value":{"type":"number"},"window_h":{"type":"number"},"actual":{"type":["number","null"]},"holds":{"type":"boolean"},"words":{"type":"string"},"unit":{"type":"string"}},"required":["feature","op","value","actual","holds","words","unit"],"additionalProperties":false}},"basis":{"anyOf":[{"type":"string","enum":["top","band"]},{"type":"null"}]}},"required":["moment","ask","bid","phase","outcome","days_to_end","conditions","basis"],"additionalProperties":false},{"type":"null"}]}},"required":["wallet","token_id","condition_id","title","category","signal_at","leader_price","leader_usd","outcome","reason","entry_at","entry_price","entry_delay_s","clip_usd","tradable_usd","exit_at","exit_price","won","pnl_usd","settled_at"],"additionalProperties":false}}},"required":["id","strategy_id","status","wallets","wallets_refreshed_at","started_at","stopped_at","graded_at","resolved_copies","promotable","stats","notes","known_issues","kind","copies"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-paper-runs-2","summary":"GET /v1/lab/paper-runs/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/notify":{"get":{"tags":["lab"],"description":"The caller’s ACTIVE paper runs and what each one sends: `none`, `summary` (a daily summary; the default) or `every_copy` (each paper copy and settlement as it happens, plus the summary), through the account’s notification channels. 404 `lab_notify_disabled` while LAB_NOTIFY_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strategy_id":{"type":"string"},"strategy_name":{"type":"string"},"started_at":{"type":"string"},"notify":{"type":"string","enum":["none","summary","every_copy"]}},"required":["id","strategy_id","strategy_name","started_at","notify"],"additionalProperties":false}}},"required":["runs"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-notify","summary":"GET /v1/lab/notify","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/paper-runs/{id}/notify":{"put":{"tags":["lab"],"description":"Change what one of the caller’s paper runs sends: `none`, `summary` or `every_copy`. 404 when the run is not the caller’s. 404 `lab_notify_disabled` while LAB_NOTIFY_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notify":{"type":"string","enum":["none","summary","every_copy"]}},"required":["notify"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"notify":{"type":"string","enum":["none","summary","every_copy"]}},"required":["id","notify"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"put-lab-paper-runs-notify","summary":"PUT /v1/lab/paper-runs/{id}/notify","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/telegram":{"get":{"tags":["alerts"],"description":"The account’s Telegram link (the @username, never the chat id), its channel switch and the bot to open. 404 `telegram_disabled` while TELEGRAM_LINK_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"bot_username":{"type":["string","null"]},"linked":{"type":"boolean"},"username":{"type":["string","null"]},"linked_at":{"type":["string","null"]},"notify":{"type":"boolean"}},"required":["bot_username","linked","username","linked_at","notify"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-telegram","summary":"GET /v1/telegram","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/telegram/link":{"post":{"tags":["alerts"],"description":"A one-time deep link to the Polyrank bot (t.me/?start=link_): opening it in Telegram connects that chat to this account. 15 minutes, single use; a new link voids the earlier ones. Needs a signed-in session. 503 `telegram_unavailable` when the bot cannot be reached. 404 `telegram_disabled` while TELEGRAM_LINK_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"expires_at":{"type":"string"}},"required":["url","expires_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-telegram-link","summary":"POST /v1/telegram/link","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["alerts"],"description":"Disconnect Telegram: the chat stops receiving notifications and the channel switch turns off. Needs a signed-in session. 404 `telegram_disabled` while TELEGRAM_LINK_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"bot_username":{"type":["string","null"]},"linked":{"type":"boolean"},"username":{"type":["string","null"]},"linked_at":{"type":["string","null"]},"notify":{"type":"boolean"}},"required":["bot_username","linked","username","linked_at","notify"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-telegram-link","summary":"DELETE /v1/telegram/link","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/telegram/prefs":{"put":{"tags":["alerts"],"description":"The Telegram channel switch, beside in-app, email and browser push. Turning it on without a linked chat sends nothing until one is linked. Needs a signed-in session. 404 `telegram_disabled` while TELEGRAM_LINK_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notify":{"type":"boolean"}},"required":["notify"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"bot_username":{"type":["string","null"]},"linked":{"type":"boolean"},"username":{"type":["string","null"]},"linked_at":{"type":["string","null"]},"notify":{"type":"boolean"}},"required":["bot_username","linked","username","linked_at","notify"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"put-telegram-prefs","summary":"PUT /v1/telegram/prefs","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/telegram/test":{"post":{"tags":["alerts"],"description":"Send a test message to the linked chat. 409 `telegram_not_linked` without one; 410 `telegram_blocked` when Telegram says the bot was blocked (the link is then removed); 502 `telegram_send_failed` otherwise. Needs a signed-in session. 404 `telegram_disabled` while TELEGRAM_LINK_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"sent":{"type":"boolean","enum":[true]}},"required":["sent"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-telegram-test","summary":"POST /v1/telegram/test","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/agent":{"get":{"tags":["lab"],"description":"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.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"allowed":{"type":"boolean"},"budget_usd":{"type":"number"},"spent_today_usd":{"type":"number"},"est_questions_left":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"used_pct_of_today":{"type":["number","null"]},"resets_at":{"type":"string"},"model":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}},"required":["allowed","budget_usd","spent_today_usd","est_questions_left","used_pct_of_today","resets_at","model","notes"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-agent","summary":"GET /v1/lab/agent","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/agent/conversations":{"get":{"tags":["lab"],"description":"The caller’s assistant conversations, most recent first (at most 100). 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"conversations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["idle","queued","working","failed"]},"error":{"type":["string","null"]},"model":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","status","error","model","created_at","updated_at"],"additionalProperties":false}}},"required":["conversations"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-agent-conversations","summary":"GET /v1/lab/agent/conversations","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["lab"],"description":"Start an assistant conversation with its first message; answers 202 with the conversation (status queued) — poll GET /lab/agent/conversations/:id. Signed-in session only. 403 `plan_required` (feature `agent`: Quant and above); 429 `lab_agent_budget` once today’s allowance is used (Retry-After = seconds to midnight UTC); 429 `lab_agent_busy` while another of the caller’s conversations is answering. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":8000}},"required":["message"],"additionalProperties":false}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["idle","queued","working","failed"]},"error":{"type":["string","null"]},"model":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","status","error","model","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-agent-conversations","summary":"POST /v1/lab/agent/conversations","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/agent/conversations/{id}":{"get":{"tags":["lab"],"description":"One of the caller’s assistant conversations: its status and the readable transcript (the caller’s messages, the assistant’s answers with any notice, which tools each step used, the result cards of those steps, and each answer’s share of today’s allowance). The truth for clients that do not stream; GET …/:id/events streams a turn live. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"conversation":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["idle","queued","working","failed"]},"error":{"type":["string","null"]},"model":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","status","error","model","created_at","updated_at"],"additionalProperties":false},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"role":{"type":"string","enum":["user","assistant"]},"text":{"type":["string","null"]},"notice":{"type":["string","null"]},"tools":{"type":"array","items":{"type":"string"}},"cards":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["wallet_shortlist"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"as_of":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}]},"window":{"anyOf":[{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["from","to"],"additionalProperties":false},{"type":"null"}]},"ranked_on":{"type":["string","null"]},"wallets_ranked":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"in_sample":{"type":"boolean","enum":[true]},"simulated":{"type":"boolean","enum":[true]},"wallets":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"wallet":{"type":"string"},"copies":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"fill_rate":{"type":["number","null"]},"active_days":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"positions":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"win_rate":{"type":["number","null"]},"categories":{"type":"array","items":{"type":"string"}},"stands_out":{"type":"boolean"},"username":{"type":["string","null"]}},"required":["rank","wallet","copies","per10","t","fill_rate","active_days","positions","win_rate","categories","stands_out"],"additionalProperties":false}},"picked":{"default":[],"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"required":["kind","v","id","title","as_of","window","ranked_on","wallets_ranked","in_sample","simulated","wallets","picked","note"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["backtest_result"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"backtest_id":{"type":"string"},"strategy_id":{"type":["string","null"]},"strategy_name":{"type":["string","null"]},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"verdict":{"type":"string","enum":["weak","promising","strong"]},"verdict_reasons":{"type":"array","items":{"type":"string"}},"per10":{"type":["number","null"]},"t":{"type":["number","null"]},"control_per10":{"type":["number","null"]},"without_best_wallet_per10":{"type":["number","null"]},"without_best_3_days_per10":{"type":["number","null"]},"copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"data_from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"data_through":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"days_with_copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"periods":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"in_sample_periods":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bankroll":{"type":"object","properties":{"start_usd":{"type":"number"},"end_usd":{"type":"number"},"return_pct":{"type":"number"},"max_drawdown_pct":{"type":"number"},"weekly":{"type":"array","items":{"type":"object","properties":{"week":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"value_usd":{"type":"number"}},"required":["week","value_usd"],"additionalProperties":false}}},"required":["start_usd","end_usd","return_pct","max_drawdown_pct","weekly"],"additionalProperties":false},"caveat":{"type":["string","null"]},"exits":{"type":"string"},"rules":{"type":"object","properties":{"baseline_per10":{"type":["number","null"]},"markets_chosen_per10":{"type":["number","null"]},"t_clustered":{"type":["number","null"]},"events":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"without_best_market_per10":{"type":["number","null"]},"variants":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expected_best_t":{"type":["number","null"]},"holdout":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sealed":{"type":"boolean"},"final_test":{"type":"boolean"}},"required":["from","to","sealed","final_test"],"additionalProperties":false},"words":{"type":"string"}},"required":["baseline_per10","markets_chosen_per10","t_clustered","events","without_best_market_per10","variants","expected_best_t","holdout","words"],"additionalProperties":false},"report_path":{"type":"string"},"simulated":{"type":"boolean","enum":[true]}},"required":["kind","v","id","title","backtest_id","strategy_id","strategy_name","from","to","verdict","verdict_reasons","per10","t","control_per10","without_best_wallet_per10","without_best_3_days_per10","copies","days","periods","in_sample_periods","bankroll","caveat","report_path","simulated"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["paper_run"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"paper_run_id":{"type":"string"},"strategy_name":{"type":["string","null"]},"status":{"type":"string"},"started_at":{"type":["string","null"]},"wallets":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"copies":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"resolved_copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"gate_copies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"per10":{"type":["number","null"]},"win_rate":{"type":["number","null"]},"entry_vs_leader_cents":{"type":["number","null"]},"passed_paper_gate":{"type":"boolean"},"page_path":{"type":"string"},"simulated":{"type":"boolean","enum":[true]},"known_issues":{"type":"array","items":{"type":"string"}}},"required":["kind","v","id","title","paper_run_id","strategy_name","status","started_at","wallets","copies","resolved_copies","gate_copies","per10","win_rate","entry_vs_leader_cents","passed_paper_gate","page_path","simulated"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["strategy"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"strategy_id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"action":{"type":"string","enum":["created","updated","opened"]},"summary":{"type":"array","items":{"type":"string"}},"defaults":{"type":"array","items":{"type":"string"}},"page_path":{"type":"string"}},"required":["kind","v","id","title","strategy_id","name","status","action","summary","page_path"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["market"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"condition_id":{"type":["string","null"]},"slug":{"type":["string","null"]},"question":{"type":"string"},"outcomes":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":["number","null"]}},"required":["name","price"],"additionalProperties":false}},"end_date":{"type":["string","null"]},"volume_usd":{"type":["number","null"]},"liquidity_usd":{"type":["number","null"]},"closed":{"type":["boolean","null"]},"category":{"type":["string","null"]}},"required":["kind","v","id","title","condition_id","slug","question","outcomes","end_date","volume_usd","liquidity_usd","closed","category"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["data_table"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"columns":{"type":"array","items":{}},"rows":{"type":"array","items":{"type":"array","items":{"type":["string","number","boolean","null"]}}},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated":{"type":"boolean"},"seconds":{"type":["number","null"]}},"required":["kind","v","id","title","columns","rows","row_count","truncated","seconds"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["data_chart"]},"v":{"type":"number","enum":[1]},"id":{"type":"string"},"title":{"type":"string"},"chart":{"type":"string","enum":["line","bar"]},"x":{},"series":{"type":"array","items":{}},"x_values":{"type":"array","items":{"type":["string","number"]}},"row_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated":{"type":"boolean"}},"required":["kind","v","id","title","chart","x","series","x_values","row_count","truncated"],"additionalProperties":false}]}},"turn_pct_of_budget":{"type":["number","null"]},"created_at":{"type":"string"}},"required":["id","role","text","notice","tools","cards","turn_pct_of_budget","created_at"],"additionalProperties":false}}},"required":["conversation","messages"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-lab-agent-conversations-2","summary":"GET /v1/lab/agent/conversations/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"patch":{"tags":["lab"],"description":"Rename one of the caller’s assistant conversations (founder 2026-10-21: an automatic title outlived its topic). The title is plain text, trimmed, at most 80 characters; an empty one is refused (400). A renamed conversation keeps its name: the automatic title is only ever given to a new one. Signed-in session only. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":200}},"required":["title"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["idle","queued","working","failed"]},"error":{"type":["string","null"]},"model":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","status","error","model","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-lab-agent-conversations","summary":"PATCH /v1/lab/agent/conversations/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["lab"],"description":"Delete one of the caller’s assistant conversations and its transcript (strategies and backtests it created stay). Signed-in session only. 409 `lab_agent_working` while it is answering. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-lab-agent-conversations","summary":"DELETE /v1/lab/agent/conversations/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/agent/conversations/{id}/messages":{"post":{"tags":["lab"],"description":"Send the next message of one of the caller’s assistant conversations; answers 202 (status queued). Signed-in session only. 409 `lab_agent_working` while the conversation is answering; 403 `plan_required` (feature `agent`); 429 `lab_agent_budget` / `lab_agent_busy` as on POST /lab/agent/conversations. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":8000}},"required":["message"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["idle","queued","working","failed"]},"error":{"type":["string","null"]},"model":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","title","status","error","model","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-agent-conversations-messages","summary":"POST /v1/lab/agent/conversations/{id}/messages","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/agent/conversations/{id}/stop":{"post":{"tags":["lab"],"description":"Stop the assistant’s answer in one of the caller’s conversations. A turn still queued is withdrawn at once (200, status idle; the message stays in the transcript, unanswered). A running turn is asked to stop (202, stopping: true): the runner stops between steps or mid-answer within about a second, keeps what it finished (finished steps and their cards, the answer text written so far) and ends the turn (the event stream says `stopped`, then `turn_end`). A conversation not answering answers 200 with stopping false. Signed-in session only. 503 `lab_agent_live_unavailable` when the stop cannot be passed on. 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["idle","queued","working","failed"]},"stopping":{"type":"boolean"}},"required":["status","stopping"],"additionalProperties":false}}}},"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["idle","queued","working","failed"]},"stopping":{"type":"boolean"}},"required":["status","stopping"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-lab-agent-conversations-stop","summary":"POST /v1/lab/agent/conversations/{id}/stop","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/lab/agent/conversations/{id}/events":{"get":{"tags":["lab"],"description":"The live events of one of the caller’s assistant conversations, as Server-Sent Events (text/event-stream; each frame `id: ` + `data: `). Without Last-Event-ID: the turn answering the conversation’s latest message, from its start (or from now, while it is still queued). With Last-Event-ID (the header, or ?last_event_id=): every event after it. A comment line every 15 s keeps the connection open; it closes after `turn_end` (or after 10 minutes: reconnect with Last-Event-ID). A `turn_end` without an id means the turn had already ended and its events are no longer kept: read GET …/:id. Events and cards: docs/LAB_AGENT_STREAM_CONTRACT.md. 503 `lab_agent_live_unavailable` when the live stream cannot be read (poll GET …/:id instead). 404 `lab_agent_disabled` while LAB_AGENT_ENABLED is off.","parameters":[{"schema":{"type":"string","maxLength":64},"in":"query","name":"last_event_id","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}},"operationId":"get-lab-agent-conversations-events","summary":"GET /v1/lab/agent/conversations/{id}/events","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/user-prefs":{"get":{"tags":["user"],"description":"The authenticated user's UI preferences. With no saved view mode, `view_mode` is the plan default (paid → advanced, free → essentials) and `view_mode_saved` is false. `onboarding` is present ONLY for an account that has an onboarding record (accounts created after the onboarding rebuild); its absence means the onboarding is never shown.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"view_mode":{"type":"string","enum":["essentials","advanced"]},"view_mode_saved":{"type":"boolean"},"default_view_mode":{"type":"string","enum":["essentials","advanced"]},"onboarding":{"type":"object","properties":{"state":{"type":"string","enum":["pending","done","dismissed"]},"step":{"type":"integer","minimum":0,"maximum":2},"answers":{"type":"object","properties":{"styles":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"topics":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["styles","topics"],"additionalProperties":false},"checklist_closed":{"type":"boolean"}},"required":["state","step","answers","checklist_closed"],"additionalProperties":false}},"required":["view_mode","view_mode_saved","default_view_mode"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-user-prefs","summary":"GET /v1/user-prefs","security":[{"apiKey":[]},{"sessionCookie":[]}]},"patch":{"tags":["user"],"description":"Save preferences for this account (all devices). Send `view_mode`, `onboarding`, or both; no other key. `view_mode: null` clears the choice, so the plan default applies again. `onboarding` is the WHOLE record ({ state: pending | done | dismissed, step: 0..2, answers: { styles, topics } (each at most 20 strings of at most 64 characters), checklist_closed }) and replaces the stored one; an account without an onboarding record answers 409 `onboarding_not_available` and nothing is saved.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"view_mode":{"anyOf":[{"type":"string","enum":["essentials","advanced"]},{"type":"null"}]},"onboarding":{"type":"object","properties":{"state":{"type":"string","enum":["pending","done","dismissed"]},"step":{"type":"integer","minimum":0,"maximum":2},"answers":{"type":"object","properties":{"styles":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"topics":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["styles","topics"],"additionalProperties":false},"checklist_closed":{"type":"boolean"}},"required":["state","step","answers","checklist_closed"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"view_mode":{"type":"string","enum":["essentials","advanced"]},"view_mode_saved":{"type":"boolean"},"default_view_mode":{"type":"string","enum":["essentials","advanced"]},"onboarding":{"type":"object","properties":{"state":{"type":"string","enum":["pending","done","dismissed"]},"step":{"type":"integer","minimum":0,"maximum":2},"answers":{"type":"object","properties":{"styles":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"topics":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["styles","topics"],"additionalProperties":false},"checklist_closed":{"type":"boolean"}},"required":["state","step","answers","checklist_closed"],"additionalProperties":false}},"required":["view_mode","view_mode_saved","default_view_mode"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-user-prefs","summary":"PATCH /v1/user-prefs","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/push/vapid-public-key":{"get":{"tags":["push"],"description":"The VAPID applicationServerKey for PushManager.subscribe (null if push is unconfigured).","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":["string","null"]}},"required":["key"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-push-vapid-public-key","summary":"GET /v1/push/vapid-public-key","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/push/subscribe":{"post":{"tags":["push"],"description":"Register a browser push subscription.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string","maxLength":2000,"format":"uri"},"keys":{"type":"object","properties":{"p256dh":{"type":"string","maxLength":500},"auth":{"type":"string","maxLength":500}},"required":["p256dh","auth"]}},"required":["endpoint","keys"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true]}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-push-subscribe","summary":"POST /v1/push/subscribe","security":[{"apiKey":[]},{"sessionCookie":[]}]},"delete":{"tags":["push"],"description":"Remove a browser push subscription.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"string","maxLength":2000,"format":"uri"}},"required":["endpoint"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"delete-push-subscribe","summary":"DELETE /v1/push/subscribe","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/me":{"get":{"tags":["referral"],"description":"Your referral code, link, lifetime earnings, funnel + projection basis.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"link":{"type":"string"},"rate":{"type":"number"},"payout_threshold_usdc":{"type":"number"},"referred_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paying_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"views":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"accrued_usdc":{"type":"number"},"paid_usdc":{"type":"number"},"pending_usdc":{"type":"number"},"annual_value_per_referral_usdc":{"type":"number"},"has_pending_payout":{"type":"boolean"},"milestones_claimed":{"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["code","link","rate","payout_threshold_usdc","referred_count","paying_count","views","accrued_usdc","paid_usdc","pending_usdc","annual_value_per_referral_usdc","has_pending_payout","milestones_claimed"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-referral-me","summary":"GET /v1/referral/me","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/resolve/{code}":{"get":{"tags":["referral"],"description":"Check whether a referral code resolves to a real referrer (public).","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":32},"in":"path","name":"code","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"valid":{"type":"boolean"},"code":{"type":"string"}},"required":["valid","code"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-referral-resolve","summary":"GET /v1/referral/resolve/{code}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/code":{"patch":{"tags":["referral"],"description":"Set a custom referral code (must be available + appropriate).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":20}},"required":["code"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"code":{"type":"string"},"link":{"type":"string"}},"required":["ok","code","link"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"patch-referral-code","summary":"PATCH /v1/referral/code","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/commissions":{"get":{"tags":["referral"],"description":"Your referral commission ledger (most recent first).","parameters":[{"schema":{"default":50,"type":"integer","minimum":1,"maximum":200},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"commissions":{"type":"array","items":{"type":"object","properties":{"created_at":{"type":"string"},"provider":{"type":"string"},"gross_amount_usdc":{"type":"number"},"rate":{"type":"number"},"commission_usdc":{"type":"number"},"status":{"type":"string"}},"required":["created_at","provider","gross_amount_usdc","rate","commission_usdc","status"],"additionalProperties":false}}},"required":["commissions"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-referral-commissions","summary":"GET /v1/referral/commissions","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/payouts":{"get":{"tags":["referral"],"description":"Your withdrawal/payout history.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"payouts":{"type":"array","items":{"type":"object","properties":{"amount_usdc":{"type":"number"},"status":{"type":"string"},"payout_wallet":{"type":["string","null"]},"tx_ref":{"type":["string","null"]},"requested_at":{"type":"string"}},"required":["amount_usdc","status","payout_wallet","tx_ref","requested_at"],"additionalProperties":false}}},"required":["payouts"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-referral-payouts","summary":"GET /v1/referral/payouts","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/payout-request":{"post":{"tags":["referral"],"description":"Request a USDC withdrawal of your pending balance (processed manually).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"amount_usdc":{"type":"number"}},"required":["ok","amount_usdc"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-referral-payout-request","summary":"POST /v1/referral/payout-request","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/track-view":{"post":{"tags":["referral"],"description":"Increment a referral link view counter (public, best-effort).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":32}},"required":["code"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-referral-track-view","summary":"POST /v1/referral/track-view","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/referral/bind":{"post":{"tags":["referral"],"description":"Bind a referral code to the (newly signed-up) caller. First-touch, immutable.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":32}},"required":["code"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"bound":{"type":"boolean"},"reason":{"type":"string","enum":["bound","self","invalid_code","already_bound","not_new"]}},"required":["bound","reason"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-referral-bind","summary":"POST /v1/referral/bind","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/redeem/{code}":{"get":{"tags":["redeem"],"description":"Preview a comp-invite code (public). Does not consume it.","parameters":[{"schema":{"type":"string","minLength":4,"maxLength":40},"in":"path","name":"code","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok","redeemed","expired","invalid"]},"plan_id":{"type":["string","null"]},"months":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["status","plan_id","months"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-redeem","summary":"GET /v1/redeem/{code}","security":[{"apiKey":[]},{"sessionCookie":[]}]},"post":{"tags":["redeem"],"description":"Redeem a comp-invite code → grant a free comp subscription (single-use).","parameters":[{"schema":{"type":"string","minLength":4,"maxLength":40},"in":"path","name":"code","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"plan_id":{"type":"string"},"months":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current_period_end":{"type":"string"}},"required":["ok","plan_id","months","current_period_end"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-redeem","summary":"POST /v1/redeem/{code}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/feedback":{"post":{"tags":["feedback"],"description":"Submit in-app feedback (bug / feature request / general) with optional attachments.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["bug","feature","general"]},"message":{"type":"string","minLength":4,"maxLength":4000},"path":{"type":"string","maxLength":512},"attachments":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"filename":{"type":"string","maxLength":200},"content_b64":{"type":"string","maxLength":2900000}},"required":["filename","content_b64"]}}},"required":["type","message"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"id":{"type":"string"},"attachments":{"type":"number"}},"required":["ok","id","attachments"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-feedback","summary":"POST /v1/feedback","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/feedback/attachments/{id}":{"get":{"tags":["feedback"],"description":"Stream a feedback attachment via its signed email link.","parameters":[{"schema":{"type":"string","maxLength":200},"in":"query","name":"t","required":false},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response"}},"operationId":"get-feedback-attachments","summary":"GET /v1/feedback/attachments/{id}","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/meta/flags":{"get":{"tags":["meta"],"description":"Public feature-flag state (booleans only, no secrets). One call lets an agent/API client discover which flag-gated surfaces are live instead of probe-and-degrade.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"flags":{"type":"object","properties":{"PUBLIC_API_ENABLED":{"type":"boolean"},"MARKET_BOOK_DEPTH_ENABLED":{"type":"boolean"},"MARKET_SKILL_FLOW_ENABLED":{"type":"boolean"},"UMA_DISPUTE_RISK_ENABLED":{"type":"boolean"},"USER_RANKING_ENABLED":{"type":"boolean"},"POSITION_ROLLUP_ENABLED":{"type":"boolean"},"AGENT_WEBHOOKS_ENABLED":{"type":"boolean"},"AGENT_CREDITS_ENABLED":{"type":"boolean"}},"required":["PUBLIC_API_ENABLED","MARKET_BOOK_DEPTH_ENABLED","MARKET_SKILL_FLOW_ENABLED","UMA_DISPUTE_RISK_ENABLED","USER_RANKING_ENABLED","POSITION_ROLLUP_ENABLED","AGENT_WEBHOOKS_ENABLED","AGENT_CREDITS_ENABLED"],"additionalProperties":false},"as_of":{"type":"string"}},"required":["flags","as_of"],"additionalProperties":false}}}}},"operationId":"get-meta-flags","summary":"GET /v1/meta/flags","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/meta/freshness":{"get":{"tags":["meta"],"description":"The freshness frontier: for every served surface, the exact block (or observation time) it currently reflects, its anchor class (block/time/slot/cohort), and its staleness budget. One call replaces per-widget staleness folklore. A registered surface with no stamp yet is status:\"unmeasured\" — absence never means fresh. Each surface also carries its SLO (class, 7-day attainment target, the attainment measured before the target was set) and its state: fresh, paused (its job is deliberately waiting behind a nightly recompute — the age shown is still the real age), stale (a stall), overrun (paused longer than ever measured) or unmeasured.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"surfaces":{"type":"array","items":{"type":"object","properties":{"surface":{"type":"string"},"anchor":{"type":"string","enum":["block","time","slot","cohort"]},"label":{"type":"string"},"source_jobs":{"type":"array","items":{"type":"string"}},"budget_seconds":{"type":"number"},"status":{"type":"string","enum":["measured","unmeasured"]},"as_of_block":{"type":["string","null"]},"as_of_time":{"type":["string","null"]},"input_frontier":{"type":["string","null"]},"input_surface":{"type":["string","null"]},"source_job":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"slo_class":{"type":"string","enum":["chain","realtime","observation","slot","batch","cohort","pipeline"]},"slo_target":{"type":"number"},"state":{"type":"string","enum":["fresh","paused","stale","overrun","unmeasured"]},"state_reason":{"type":["string","null"]},"yield_since":{"type":["string","null"]},"yield_ceiling_seconds":{"type":["number","null"]},"provisional":{"type":["string","null"]},"availability":{"type":"string","enum":["ok","empty","missing","unknown","unmapped"]},"availability_rows":{"type":["number","null"]},"availability_tables":{"type":"array","items":{"type":"string"}},"measured":{"anyOf":[{"type":"object","properties":{"within_slo":{"type":"number"},"within_budget":{"type":"number"},"p50_seconds":{"type":"number"},"p99_seconds":{"type":"number"},"max_seconds":{"type":"number"},"method":{"type":"string","enum":["state_gauge","yield_proxy","all_day"]}},"required":["within_slo","within_budget","p50_seconds","p99_seconds","max_seconds","method"],"additionalProperties":false},{"type":"null"}]}},"required":["surface","anchor","label","source_jobs","budget_seconds","status","as_of_block","as_of_time","input_frontier","input_surface","source_job","updated_at","age_seconds","slo_class","slo_target","state","state_reason","yield_since","yield_ceiling_seconds","provisional","availability","availability_rows","availability_tables","measured"],"additionalProperties":false}},"frontier_readable":{"type":"boolean"},"as_of":{"type":"string"},"slo_classes":{"type":"array","items":{"type":"object","properties":{"slo_class":{"type":"string"},"label":{"type":"string"},"surfaces":{"type":"array","items":{"type":"string"}},"budget_seconds":{"type":"number"},"slo_target":{"type":"number"},"provisional":{"type":"boolean"},"has_yields":{"type":"boolean"}},"required":["slo_class","label","surfaces","budget_seconds","slo_target","provisional","has_yields"],"additionalProperties":false}},"slo_evidence":{"type":"object","properties":{"measured_from":{"type":"string"},"measured_through":{"type":"string"},"source":{"type":"string"}},"required":["measured_from","measured_through","source"],"additionalProperties":false},"yields_readable":{"type":"boolean"},"availability_readable":{"type":"boolean"}},"required":["surfaces","frontier_readable","as_of","slo_classes","slo_evidence","yields_readable","availability_readable"],"additionalProperties":false}}}}},"operationId":"get-meta-freshness","summary":"GET /v1/meta/freshness","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/client-errors":{"post":{"tags":["meta"],"description":"Report a browser-side crash caught by the web error screens (logged, not stored).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"boundary":{"type":"string","enum":["route","global"]},"name":{"type":"string","maxLength":100},"message":{"type":"string","maxLength":1000},"stack":{"type":"string","maxLength":6000},"digest":{"type":"string","maxLength":100},"path":{"type":"string","maxLength":500}},"required":["boundary","message"]}}}},"responses":{"204":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"post-client-errors","summary":"POST /v1/client-errors","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/public/referrer":{"get":{"tags":["public"],"description":"Resolve an invite code to the inviter’s public display name / X handle.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"code","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":["string","null"]},"x_username":{"type":["string","null"]}},"required":["display_name","x_username"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-referrer","summary":"GET /v1/public/referrer"}},"/v1/public/movers":{"get":{"tags":["public"],"description":"Daily-refreshing skill-rank climbers/fallers over a sliding lookback window.","parameters":[{"schema":{"default":"polyrank-default","type":"string","enum":["polyrank-default"]},"in":"query","name":"preset","required":false},{"schema":{"default":7,"type":"integer","minimum":1,"maximum":30},"in":"query","name":"lookback_days","required":false},{"schema":{"default":5,"type":"integer","minimum":1,"maximum":10},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"preset":{"type":"string"},"as_of":{"type":["string","null"]},"since":{"type":["string","null"]},"lookback_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"movers_up":{"type":"array","items":{"type":"object","properties":{"tid":{"type":"string"},"wallet_label":{"type":"string"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prev_rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"composite_score":{"type":"number"}},"required":["tid","wallet_label","display","rank","prev_rank","composite_score"],"additionalProperties":false}},"movers_down":{"type":"array","items":{"type":"object","properties":{"tid":{"type":"string"},"wallet_label":{"type":"string"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prev_rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"composite_score":{"type":"number"}},"required":["tid","wallet_label","display","rank","prev_rank","composite_score"],"additionalProperties":false}}},"required":["preset","as_of","since","lookback_days","movers_up","movers_down"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-movers","summary":"GET /v1/public/movers"}},"/v1/public/trader/{proxy}":{"get":{"tags":["public"],"description":"Public teaser: identity + commodity P&L/volume/win-rate + composite rank. Deep skill metrics, trades, and positions are gated.","parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"composite_score":{"type":["number","null"]},"total_pnl":{"type":["number","null"]},"total_pnl_net_fees":{"type":["number","null"]},"realized_pnl":{"type":["number","null"]},"pnl_under_review":{"type":"boolean"},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"percentiles":{"type":"object","properties":{"total_pnl":{"type":["number","null"]},"realized_pnl":{"type":["number","null"]},"lifetime_volume_usdc":{"type":["number","null"]},"win_rate_pct":{"type":["number","null"]}},"required":["total_pnl","realized_pnl","lifetime_volume_usdc","win_rate_pct"],"additionalProperties":false},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"x_username":{"type":["string","null"]},"verified":{"type":"boolean"},"eoa":{"type":["string","null"]},"claimed":{"type":"boolean"},"founding":{"type":"boolean"}},"required":["username","pseudonym","profile_image","x_username","verified","eoa","claimed","founding"],"additionalProperties":false},"first_trade_at":{"type":["string","null"]},"last_trade_at":{"type":["string","null"]},"locked_metric_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["proxy_wallet","rank","composite_score","total_pnl","total_pnl_net_fees","realized_pnl","pnl_under_review","lifetime_volume_usdc","trade_count","markets_traded","win_rate_pct","percentiles","display","first_trade_at","last_trade_at","locked_metric_count","snapshot_age_seconds"],"additionalProperties":false}}}},"304":{"description":"Default Response"},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-trader","summary":"GET /v1/public/trader/{proxy}"}},"/v1/public/trader/{proxy}/calibration":{"get":{"tags":["public"],"description":"Public reliability diagram: 10 predicted-vs-observed bins.","parameters":[{"schema":{"type":"string"},"in":"path","name":"proxy","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"},"bins":{"minItems":10,"maxItems":10,"type":"array","items":{"type":"object","properties":{"bin_idx":{"type":"integer","minimum":0,"maximum":9},"bin_label":{"type":"string"},"predicted_mean":{"type":"number"},"observed_rate":{"type":["number","null"]},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bin_idx","bin_label","predicted_mean","observed_rate","n"],"additionalProperties":false}},"n_total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["proxy_wallet","bins","n_total"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-trader-calibration","summary":"GET /v1/public/trader/{proxy}/calibration"}},"/v1/public/market/{id}":{"get":{"tags":["public"],"description":"Public market teaser: holder average entry (Brier-weighted average price current holders paid for YES — a cost basis, not a forecast) + its delta vs mid + 24h totals + top-5 holders. Full positioning/flow/fills are gated.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":160},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"condition_id":{"type":"string"},"outcome_names":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"combo":{"anyOf":[{"type":"object","properties":{"n_legs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_resolved_legs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"yes_estimate":{"type":["number","null"]},"legs":{"type":"array","items":{"type":"object","properties":{"leg_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"market_condition_id":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"market_category":{"type":["string","null"]},"side_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"side_label":{"type":"string"},"status":{"type":"string","enum":["open","won","lost","partial","unknown"]},"price":{"type":["number","null"]}},"required":["leg_index","market_condition_id","market_title","market_slug","market_category","side_index","side_label","status","price"],"additionalProperties":false}}},"required":["n_legs","n_resolved_legs","yes_estimate","legs"],"additionalProperties":false},{"type":"null"}]},"market_title":{"type":["string","null"]},"market_category":{"type":["string","null"]},"market_subcategory":{"description":"Sub-category id inside `market_category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"market_subcategory_label":{"description":"Display label of `market_subcategory`.","type":["string","null"]},"market_subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"market_subtype_label":{"description":"Display label of `market_subtype`.","type":["string","null"]},"market_slug":{"type":["string","null"]},"end_date":{"type":["string","null"]},"resolved":{"type":"boolean"},"market_state":{"type":"string","enum":["LIVE","RESOLVING","RESOLVED","DORMANT"]},"event":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"slug":{"type":["string","null"]},"title":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"type":["string","null"]},"series_title":{"type":["string","null"]},"series_slug":{"type":["string","null"]},"series_recurrence":{"type":["string","null"]},"sport_code":{"type":["string","null"]},"sport_name":{"type":["string","null"]},"sport_discipline":{"type":["string","null"]},"team_names":{"type":"array","items":{"type":"string"}},"market_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"game_id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"live":{"type":["boolean","null"]},"ended":{"type":["boolean","null"]},"score":{"type":["string","null"]},"period":{"type":["string","null"]}},"required":["id","slug","title","category","subcategory","series_title","series_slug","series_recurrence","sport_code","sport_name","sport_discipline","team_names","market_count","game_id","live","ended","score","period"],"additionalProperties":false},{"type":"null"}]},"market_meta":{"anyOf":[{"type":"object","properties":{"sports_market_type":{"type":["string","null"]},"group_item_title":{"type":["string","null"]},"neg_risk":{"type":"boolean"},"neg_risk_market_id":{"type":["string","null"]},"resolution_source":{"type":["string","null"]},"fee_type":{"type":["string","null"]},"fee_rate":{"type":["number","null"]},"fee_rebate_rate":{"type":["number","null"]},"fee_taker_only":{"type":["boolean","null"]},"uma_bond":{"type":["number","null"]},"uma_reward":{"type":["number","null"]},"custom_liveness":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"uma_resolution_status":{"type":["string","null"]},"resolved_by":{"type":["string","null"]},"line":{"type":["number","null"]}},"required":["sports_market_type","group_item_title","neg_risk","neg_risk_market_id","resolution_source","fee_type","fee_rate","fee_rebate_rate","fee_taker_only","uma_bond","uma_reward","custom_liveness","uma_resolution_status","resolved_by","line"],"additionalProperties":false},{"type":"null"}]},"dates":{"type":"object","properties":{"listed":{"description":"Gamma market `createdAt`: when the market was created on Polymarket.","type":["string","null"]},"trading_opens":{"description":"Gamma market `acceptingOrdersTimestamp`: when the order book opened.","type":["string","null"]},"first_trade":{"description":"Ours: the first fill indexed for this market (poly.fills_dedup).","type":["string","null"]},"last_trade":{"description":"Ours: the latest fill indexed for this market (poly.fills_dedup).","type":["string","null"]},"event_start":{"description":"Gamma event `startTime` (else the market `eventStartTime`). A kick-off on sports events; on other events Gamma sets it at or near the listing, so it is NOT a scheduled real-world start there.","type":["string","null"]},"game_start":{"description":"Gamma market `gameStartTime`: the kick-off, on sports markets only.","type":["string","null"]},"scheduled_close":{"description":"Gamma market `endDate`: the date the question becomes eligible for resolution. NOT the end of trading: a market keeps trading past it until it is resolved, so it can be in the past on a live market (on sports it is usually the kick-off).","type":["string","null"]},"actual_close":{"description":"Gamma market `closedTime`: when Polymarket closed the market. Known only after the fact; null while the market is open.","type":["string","null"]},"resolved":{"description":"When the market resolved (poly.markets.resolution_time); null until then.","type":["string","null"]}},"required":["listed","trading_opens","first_trade","last_trade","event_start","game_start","scheduled_close","actual_close","resolved"],"additionalProperties":false},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"current_mid":{"type":["number","null"]},"last_24h_volume_usdc":{"type":"number"},"last_24h_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"positioner_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"smart_money_positioner_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"consensus_latest":{"anyOf":[{"type":"object","properties":{"polyrank_consensus_yes":{"type":"number"},"market_mid":{"type":"number"},"n_positioners":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["polyrank_consensus_yes","market_mid","n_positioners"],"additionalProperties":false},{"type":"null"}]},"top_holders":{"type":"array","items":{"type":"object","properties":{"pseudonym":{"type":["string","null"]},"outcome_side":{"type":"string","enum":["YES","NO"]},"shares_held":{"type":"number"}},"required":["pseudonym","outcome_side","shares_held"],"additionalProperties":false}},"locked":{"type":"object","properties":{"positioning":{"type":"boolean"},"flow":{"type":"boolean"},"fills":{"type":"boolean"}},"required":["positioning","flow","fills"],"additionalProperties":false},"mid_age_seconds":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["condition_id","outcome_names","combo","market_title","market_category","market_subcategory","market_subcategory_label","market_subtype","market_subtype_label","market_slug","end_date","resolved","market_state","event","market_meta","dates","winner_outcome","current_mid","last_24h_volume_usdc","last_24h_fills","positioner_count","smart_money_positioner_count","consensus_latest","top_holders","locked","mid_age_seconds","snapshot_age_seconds"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-market","summary":"GET /v1/public/market/{id}"}},"/v1/public/event/{slug}":{"get":{"tags":["public"],"description":"Public event (fixture) view: header, dates, and every question in the fixture with our 24h volume and live mids.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":160},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"canonical_slug":{"type":"string"},"event_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"title":{"type":"string"},"description":{"description":"Gamma's description of the event: its resolution rules, as plain text. Paragraphs are separated by newlines; URLs are bare text and nothing in it is markup, so render it as text (never as HTML or Markdown). Control characters are removed and it is cut at 10000 characters with a trailing ellipsis. Null when Gamma has none or it is not stored yet.","type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Gamma's own tag for the event (a sport name, or its first tag label): free text, not our registry. Ours is `market_subcategory`.","type":["string","null"]},"market_subcategory":{"description":"Sub-category id inside `market_category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"market_subcategory_label":{"description":"Display label of `market_subcategory`.","type":["string","null"]},"market_subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"market_subtype_label":{"description":"Display label of `market_subtype`.","type":["string","null"]},"series_title":{"type":["string","null"]},"series_slug":{"type":["string","null"]},"series_recurrence":{"type":["string","null"]},"sport_code":{"type":["string","null"]},"sport_name":{"type":["string","null"]},"sport_discipline":{"type":["string","null"]},"team_names":{"type":"array","items":{"type":"string"}},"team_abbrs":{"type":"array","items":{"type":"string"}},"game_id":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"live":{"type":["boolean","null"]},"ended":{"type":["boolean","null"]},"score":{"type":"string"},"period":{"type":"string"},"resolution_source":{"type":"string"},"neg_risk":{"type":"boolean"},"fee":{"anyOf":[{"type":"object","properties":{"fee_type":{"type":["string","null"]},"fee_rate":{"type":["number","null"]},"fee_rebate_rate":{"type":["number","null"]},"fee_taker_only":{"type":["boolean","null"]}},"required":["fee_type","fee_rate","fee_rebate_rate","fee_taker_only"],"additionalProperties":false},{"type":"null"}],"description":"The fee schedule every question of the event shares. Null unless `fee_uniform` is true."},"fee_uniform":{"description":"True when every question carries the same fee schedule (then `fee` is it), false when they differ (read `questions[].fee`), null when it is not known for at least one question or the event has no question.","type":["boolean","null"]},"oracle":{"anyOf":[{"type":"object","properties":{"resolved_by":{"type":["string","null"]},"resolved_by_name":{"description":"A human name for `resolved_by` (\"UMA CTF Adapter v2\", \"Neg-risk UMA CTF Adapter (sports)\", ...), for the addresses we know by name. Null for any other address and when `resolved_by` is null: show the address then.","type":["string","null"]},"resolution_source":{"type":["string","null"]},"uma_bond":{"type":["number","null"]},"uma_reward":{"type":["number","null"]},"custom_liveness":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"neg_risk":{"type":"boolean"}},"required":["resolved_by","resolved_by_name","resolution_source","uma_bond","uma_reward","custom_liveness","neg_risk"],"additionalProperties":false},{"type":"null"}],"description":"The resolver and its parameters every question of the event shares. Null unless `oracle_uniform` is true."},"oracle_uniform":{"description":"True when every question names the same resolver with the same parameters (then `oracle` is it), false when they differ (read `questions[].oracle`), null when it is not known for at least one question or the event has no question.","type":["boolean","null"]},"dates":{"type":"object","properties":{"created":{"type":["string","null"]},"trading_opens":{"type":["string","null"]},"first_trade":{"type":["string","null"]},"event_start":{"type":["string","null"]},"scheduled_close":{"type":["string","null"]},"actual_close":{"type":["string","null"]}},"required":["created","trading_opens","first_trade","event_start","scheduled_close","actual_close"],"additionalProperties":false},"totals":{"type":"object","properties":{"questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"open_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolved_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"volume_24h_usdc":{"type":"number"},"volume_all_time_usd":{"type":"number"},"fills_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fills_24h_top_taker_share":{"type":["number","null"]},"fills_24h_median_usd":{"type":["number","null"]},"traders_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["questions","open_questions","resolved_questions","volume_24h_usdc","volume_all_time_usd","fills_24h","fills_24h_top_taker_share","fills_24h_median_usd","traders_24h"],"additionalProperties":false},"gamma_reported":{"type":"object","properties":{"open_interest":{"type":["number","null"]},"volume_24h_shares":{"type":["number","null"]},"liquidity":{"type":["number","null"]},"comment_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["open_interest","volume_24h_shares","liquidity","comment_count"],"additionalProperties":false},"fixture_events":{"type":"array","items":{"type":"object","properties":{"event_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"slug":{"type":"string"},"title":{"type":"string"},"market_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"is_current":{"type":"boolean"}},"required":["event_id","slug","title","market_count","is_current"],"additionalProperties":false}},"questions":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"title":{"type":"string"},"label":{"type":"string"},"group":{"type":"string"},"sports_market_type":{"type":"string"},"line":{"type":["number","null"]},"yes_mid":{"type":["number","null"]},"no_mid":{"type":["number","null"]},"quoted":{"type":"boolean"},"price_basis":{"anyOf":[{"type":"string","enum":["mid","last_trade"]},{"type":"null"}]},"has_traded":{"type":"boolean"},"fee":{"anyOf":[{"type":"object","properties":{"fee_type":{"type":["string","null"]},"fee_rate":{"type":["number","null"]},"fee_rebate_rate":{"type":["number","null"]},"fee_taker_only":{"type":["boolean","null"]}},"required":["fee_type","fee_rate","fee_rebate_rate","fee_taker_only"],"additionalProperties":false},{"type":"null"}]},"oracle":{"anyOf":[{"type":"object","properties":{"resolved_by":{"type":["string","null"]},"resolved_by_name":{"description":"A human name for `resolved_by` (\"UMA CTF Adapter v2\", \"Neg-risk UMA CTF Adapter (sports)\", ...), for the addresses we know by name. Null for any other address and when `resolved_by` is null: show the address then.","type":["string","null"]},"resolution_source":{"type":["string","null"]},"uma_bond":{"type":["number","null"]},"uma_reward":{"type":["number","null"]},"custom_liveness":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"neg_risk":{"type":"boolean"}},"required":["resolved_by","resolved_by_name","resolution_source","uma_bond","uma_reward","custom_liveness","neg_risk"],"additionalProperties":false},{"type":"null"}]},"yes_mid_as_of":{"type":["string","null"]},"no_mid_as_of":{"type":["string","null"]},"yes_token_id":{"type":"string"},"no_token_id":{"type":"string"},"volume_24h_usdc":{"type":"number"},"fills_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"resolved":{"type":"boolean"},"winner_outcome":{"anyOf":[{"type":"string","enum":["YES","NO","INVALID"]},{"type":"null"}]},"market_state":{"type":"string","enum":["LIVE","RESOLVING","RESOLVED","DORMANT"]},"scheduled_close":{"type":["string","null"]},"neg_risk_market_id":{"type":"string"},"yes_mid_freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false},"no_mid_freshness":{"type":"object","properties":{"as_of":{"type":["string","null"]},"age_seconds":{"type":["number","null"]},"class":{"type":"string","enum":["live","recent","daily","weekly","stale"]},"source":{"type":"string"}},"required":["as_of","age_seconds","class","source"],"additionalProperties":false}},"required":["condition_id","title","label","group","sports_market_type","line","yes_mid","no_mid","quoted","price_basis","has_traded","fee","oracle","yes_mid_as_of","no_mid_as_of","yes_token_id","no_token_id","volume_24h_usdc","fills_24h","resolved","winner_outcome","market_state","scheduled_close","neg_risk_market_id","yes_mid_freshness","no_mid_freshness"],"additionalProperties":false}},"live_check":{"type":"object","properties":{"mode":{"type":"string","enum":["off","record","on"]},"stale":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"refreshed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deferred":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"fetch_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","stale","refreshed","deferred","fetch_ms"],"additionalProperties":false},"freshness":{"type":"object","properties":{"mids_as_of":{"type":["string","null"]}},"required":["mids_as_of"],"additionalProperties":false},"neg_risk_groups":{"type":"array","items":{"type":"object","properties":{"neg_risk_market_id":{"type":"string"},"n_questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"n_priced":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sum_yes":{"type":"number"}},"required":["neg_risk_market_id","n_questions","n_priced","sum_yes"],"additionalProperties":false}},"as_of":{"type":"string"}},"required":["slug","canonical_slug","event_id","title","description","category","subcategory","market_subcategory","market_subcategory_label","market_subtype","market_subtype_label","series_title","series_slug","series_recurrence","sport_code","sport_name","sport_discipline","team_names","team_abbrs","game_id","live","ended","score","period","resolution_source","neg_risk","fee","fee_uniform","oracle","oracle_uniform","dates","totals","gamma_reported","fixture_events","questions","live_check","freshness","neg_risk_groups","as_of"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-event","summary":"GET /v1/public/event/{slug}"}},"/v1/public/events/top":{"get":{"tags":["public"],"description":"Open events ranked by our own 24h USDC volume, collapsed to canonical fixture slugs. Powers the sitemap.","parameters":[{"schema":{"default":500,"type":"integer","minimum":1,"maximum":2000},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"volume_24h_usdc":{"type":"number"},"questions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["slug","title","volume_24h_usdc","questions"],"additionalProperties":false}},"as_of":{"type":"string"}},"required":["events","as_of"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-events-top","summary":"GET /v1/public/events/top"}},"/v1/public/leaderboard":{"get":{"tags":["public"],"description":"Public leaderboard teaser: top-N rows + commodity columns. Per-metric sort, windows, the Builder, and rows beyond 25 are gated.","parameters":[{"schema":{"default":"polyrank-default","type":"string","maxLength":64,"pattern":"^[a-z0-9-]+$"},"in":"query","name":"preset","required":false},{"schema":{"default":25,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"preset":{"type":"string"},"served_preset":{"type":"string"},"preset_redirect":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"required":["from","to"],"additionalProperties":false},"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tid":{"type":"string"},"wallet_label":{"type":"string"},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"composite_score":{"type":"number"},"total_pnl":{"type":"number"},"win_rate_pct":{"type":["number","null"]},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"calibration_excess_z":{"type":["number","null"]},"calibration_excess_z_pctile":{"type":["number","null"]},"profit_per_dollar_risked":{"type":["number","null"]},"return_on_avg_capital":{"type":["number","null"]},"pnl_net_usdc":{"type":["number","null"]},"roi_net":{"type":["number","null"]},"prediction_accuracy_pct":{"type":["number","null"]},"prediction_n":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"prediction_avg_price":{"type":["number","null"]}},"required":["rank","tid","wallet_label","display","composite_score","total_pnl","win_rate_pct","lifetime_volume_usdc","trade_count"],"additionalProperties":false}},"total_cohort":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"eligible_universe":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"definition":{"type":"object","properties":{"weights":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"window":{"type":"string"},"weight_pct":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","window","weight_pct"],"additionalProperties":false}},"filters":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"additionalProperties":false}}},"required":["weights","filters"],"additionalProperties":false}},"required":["preset","rows","total_cohort","snapshot_age_seconds"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-leaderboard","summary":"GET /v1/public/leaderboard"}},"/v1/traders/recently-active":{"get":{"tags":["public"],"description":"Minutes-grain recently-active traders. Masked (tid + masked label, proxy_wallet null) for anonymous and API-key callers; a browser session gets the real proxy_wallet and unmasked names. Activity (which wallets) is live off the trades.new tail; the ranked metric VALUES are grid cadence. Windows 5m/15m require sign-in; >=1h are anonymous. Sort by any of: realized_pnl, total_pnl, roi_pct, win_rate_pct, lifetime_volume_usdc, trade_count.","parameters":[{"schema":{"default":"1h","type":"string","enum":["5m","15m","1h","6h","24h"]},"in":"query","name":"window","required":false},{"schema":{"default":"realized_pnl","type":"string","maxLength":48},"in":"query","name":"sort","required":false},{"schema":{"default":"lifetime","type":"string","enum":["lifetime","30d"]},"in":"query","name":"sort_window","required":false},{"schema":{"default":"desc","type":"string","enum":["asc","desc"]},"in":"query","name":"sort_dir","required":false},{"schema":{"default":25,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"window":{"type":"string"},"sort":{"type":"string"},"sort_window":{"type":"string"},"sort_dir":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"as_of":{"type":"string"},"freshness":{"type":"object","properties":{"activity":{"type":"string"},"metric_values":{"type":"string"},"metrics_snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["activity","metric_values","metrics_snapshot_age_seconds"],"additionalProperties":false},"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tid":{"type":"string"},"wallet_label":{"type":"string"},"proxy_wallet":{"type":["string","null"]},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"last_fill_at_ms":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort_value":{"type":["number","null"]},"realized_pnl":{"type":"number"},"total_pnl":{"type":"number"},"roi_pct":{"type":"number"},"win_rate_pct":{"type":["number","null"]},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rank","tid","wallet_label","proxy_wallet","display","last_fill_at_ms","sort_value","realized_pnl","total_pnl","roi_pct","win_rate_pct","lifetime_volume_usdc","trade_count"],"additionalProperties":false}}},"required":["window","sort","sort_window","sort_dir","count","as_of","freshness","rows"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-traders-recently-active","summary":"GET /v1/traders/recently-active","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/public/ranking/{slug}":{"get":{"tags":["public"],"description":"A published custom ranking by public slug. Masked top-25 + the ranking definition. The Builder, deep metrics, and full list are gated.","parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9-]{1,128}$"},"in":"path","name":"slug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"author":{"type":["string","null"]},"weights":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"window":{"type":"string"},"weight_pct":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","name","window","weight_pct"],"additionalProperties":false}},"filters":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"additionalProperties":false}},"dropped_weights":{"type":"array","items":{"type":"string"}},"dropped_gates":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"metric":{"type":"string"},"window":{"type":"string"},"reason":{"type":"string"}},"required":["kind","metric","window","reason"],"additionalProperties":false}},"rows":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tid":{"type":"string"},"wallet_label":{"type":"string"},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified"],"additionalProperties":false},"composite_score":{"type":"number"},"realized_pnl":{"type":"number"},"win_rate_pct":{"type":["number","null"]},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rank","tid","wallet_label","display","composite_score","realized_pnl","win_rate_pct","lifetime_volume_usdc","trade_count"],"additionalProperties":false}},"total_cohort":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"locked_metric_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["slug","name","author","weights","filters","rows","total_cohort","locked_metric_count","snapshot_age_seconds"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-ranking","summary":"GET /v1/public/ranking/{slug}"}},"/v1/public/trades/top-roi":{"get":{"tags":["public"],"description":"The biggest return-on-cost (\"highest ROI\") resolved trades on Polymarket. Masked identity; public trade facts.","parameters":[{"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions","Multi-category"]},"in":"query","name":"category","required":false},{"schema":{"type":"string","enum":["aapl","abnb","ai","american-football","amsterdam","amzn","ankara","atlanta","atp","auckland","austin","awards","baseball","basketball","beijing","big-tech","bitcoin","bnb","boxing","buenos-aires","busan","call-of-duty","cape-town","celebrities","chengdu","chess","chicago","chongqing","climate","coin","commodities","counter-strike","creators","cricket","cycling","dallas","darts","davis-cup","dax","denver","dji","dogecoin","dota-2","ea-sports-fc","earnings","earthquakes","economy","equities","ethereum","fed-rates","ftse","gaming","geopolitics","global-elections","golf","googl","guangzhou","handball","helsinki","hockey","hong-kong","honor-of-kings","hood","houston","hsi","hurricanes","hype","inflation","ipos","istanbul","itf","jeddah","karachi","kuala-lumpur","lacrosse","laver-cup","league-of-legends","london","los-angeles","lucknow","madrid","manila","memecoins","meta","mexico-city","miami","middle-east","milan","mma","mobile-legends","moscow","motorsport","movies","msft","mu","munich","music","natural-disasters","new-york-city","nflx","nik","nvda","nya","open","overwatch","panama-city","paris","pickleball","pltr","poker","pubg","qingdao","rainbow-six-siege","regulation","rklb","rocket-league","rugby","rut","san-francisco","sao-paulo","science","seattle","seoul","shanghai","shenzhen","singapore","soccer","solana","space","spx","starcraft","table-tennis","taipei","tel-aviv","tennis","token-launches","tokyo","toronto","treasuries","trump","tsla","tv","tweets","ukraine-russia","us-elections","us-politics","valorant","volleyball","warsaw","wta","wuhan","xrp","zcash","zhengzhou"]},"in":"query","name":"subcategory","required":false,"description":"Sub-category id inside `category` (soccer, bitcoin, us-elections …; the SUBCATEGORIES registry). Unknown id, or one that is not a sub-category of the given category: 400."},{"schema":{"type":"string","enum":["15m","1h","4h","5m","afc-champions-league","argentina-primera","atp","ballon-dor","brazil-serie-a","bundesliga","bundesliga-2","cfb","cfl","college-basketball","concacaf-nations-league","daily","denmark-superliga","efl-championship","efl-cup","epl","eredivisie","euroleague","f1","fa-cup","highest-temperature","indycar","international-cricket","international-friendlies","ipl","j1-league","j2-league","k-league","kbo","khl","la-liga","la-liga-2","libertadores","liga-mx","ligue-1","liv-golf","lowest-temperature","lpga","mlb","mls","monthly","motogp","nascar","nba","nfl","nhl","npb","nwsl","pga","precipitation","primeira-liga","saudi-pro-league","serie-a","sudamericana","super-lig","ucl","uecl","uefa-nations-league","uel","ufc","ufl","uwcl","weekly","wnba","world-cup","world-cup-qualifiers","yearly"]},"in":"query","name":"subtype","required":false,"description":"Second-level id: a Sports league (nfl, epl), a Crypto timeframe (5m, 1h, daily), a Weather metric. Unknown id, or one that does not belong to the given category / sub-category: 400."},{"schema":{"type":"integer","minimum":1,"maximum":3650},"in":"query","name":"since_days","required":false},{"schema":{"default":"roi","type":"string","enum":["roi","profit","cost","entry","recency"]},"in":"query","name":"sort","required":false},{"schema":{"default":"desc","type":"string","enum":["desc","asc"]},"in":"query","name":"dir","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"trades":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tid":{"type":"string"},"wallet_label":{"type":"string"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]}},"required":["username","pseudonym"],"additionalProperties":false},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"cost_usdc":{"type":"number"},"profit_usdc":{"type":"number"},"roi_x":{"type":"number"},"entry_price":{"type":"number"},"resolved_at":{"type":"string"}},"required":["rank","tid","wallet_label","display","market_title","market_slug","category","subcategory","subcategory_label","subtype","subtype_label","cost_usdc","profit_usdc","roi_x","entry_price","resolved_at"],"additionalProperties":false}}},"required":["trades"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-trades-top-roi","summary":"GET /v1/public/trades/top-roi"}},"/v1/public/founding":{"get":{"tags":["public"],"description":"Founding Trader offer status: seats left, deadline, locked prices.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"eligible":{"type":"boolean"},"seats_total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"seats_taken":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"seats_left":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"deadline":{"type":["string","null"]},"prices":{"type":"object","properties":{"founding_monthly_usd":{"type":"number"},"founding_annual_usd":{"type":"number"},"regular_monthly_usd":{"type":"number"},"regular_annual_usd":{"type":"number"}},"required":["founding_monthly_usd","founding_annual_usd","regular_monthly_usd","regular_annual_usd"],"additionalProperties":false}},"required":["active","eligible","seats_total","seats_taken","seats_left","deadline","prices"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-founding","summary":"GET /v1/public/founding"}},"/v1/public/pulse":{"get":{"tags":["public"],"description":"Landing live section: big wins (realized profit, winners only), sharp money moving, trending markets, and markets where holder average entry sits furthest from the current mid.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"big_wins":{"type":"array","items":{"type":"object","properties":{"tid":{"type":"string"},"wallet_label":{"type":"string"},"pseudonym":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"profit_usdc":{"type":"number"},"redeemed_usdc":{"type":"number"},"outcome":{"type":"string","enum":["YES","NO"]},"banked_at":{"type":"string"}},"required":["tid","wallet_label","pseudonym","market_title","market_slug","profit_usdc","redeemed_usdc","outcome","banked_at"],"additionalProperties":false}},"sharp_moves":{"type":"array","items":{"type":"object","properties":{"tid":{"type":"string"},"wallet_label":{"type":"string"},"pseudonym":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"notional_usdc":{"type":"number"},"is_buy":{"type":"boolean"},"price":{"type":"number"},"outcome_side":{"type":"string","enum":["YES","NO"]},"filled_at":{"type":"string"}},"required":["tid","wallet_label","pseudonym","market_title","market_slug","notional_usdc","is_buy","price","outcome_side","filled_at"],"additionalProperties":false}},"recent_big_trades":{"type":"array","items":{"type":"object","properties":{"tid":{"type":"string"},"wallet_label":{"type":"string"},"pseudonym":{"type":["string","null"]},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"notional_usdc":{"type":"number"},"price":{"type":"number"},"outcome_side":{"type":"string","enum":["YES","NO"]},"filled_at":{"type":"string"}},"required":["tid","wallet_label","pseudonym","market_title","market_slug","notional_usdc","price","outcome_side","filled_at"],"additionalProperties":false}},"trending_markets":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"volume_1h_usdc":{"type":"number"},"n_fills_1h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"latest_mid":{"type":["number","null"]}},"required":["condition_id","market_title","market_slug","category","subcategory","subcategory_label","subtype","subtype_label","volume_1h_usdc","n_fills_1h","latest_mid"],"additionalProperties":false}},"consensus_divergence":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"market_title":{"type":["string","null"]},"market_slug":{"type":["string","null"]},"category":{"type":["string","null"]},"subcategory":{"description":"Sub-category id inside `category` (the SUBCATEGORIES registry of @polyrank/shared-types): the sport for Sports, the game for Esports, the tour for Tennis, the asset for Crypto, the city for Weather, a topic elsewhere. Null when the market has none.","type":["string","null"]},"subcategory_label":{"description":"Display label of `subcategory`.","type":["string","null"]},"subtype":{"description":"Second level, where the category has one: the league for Sports (nfl, epl), the timeframe for Crypto (5m, 1h, daily), the metric for Weather. Null otherwise.","type":["string","null"]},"subtype_label":{"description":"Display label of `subtype`.","type":["string","null"]},"polyrank_yes":{"type":"number"},"market_mid":{"type":"number"},"divergence_pct":{"type":"number"},"n_positioners":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["condition_id","market_title","market_slug","category","subcategory","subcategory_label","subtype","subtype_label","polyrank_yes","market_mid","divergence_pct","n_positioners"],"additionalProperties":false}}},"required":["big_wins","sharp_moves","recent_big_trades","trending_markets","consensus_divergence"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-pulse","summary":"GET /v1/public/pulse"}},"/v1/public/t/{tid}":{"get":{"tags":["public"],"description":"Masked trader teaser by opaque id: commodity stats + calibration access, identity middle-hidden. Sign in to resolve the wallet.","parameters":[{"schema":{"type":"string","minLength":20,"maxLength":64},"in":"path","name":"tid","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"composite_score":{"type":["number","null"]},"total_pnl":{"type":["number","null"]},"total_pnl_net_fees":{"type":["number","null"]},"realized_pnl":{"type":["number","null"]},"pnl_under_review":{"type":"boolean"},"lifetime_volume_usdc":{"type":"number"},"trade_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"markets_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"win_rate_pct":{"type":["number","null"]},"percentiles":{"type":"object","properties":{"total_pnl":{"type":["number","null"]},"realized_pnl":{"type":["number","null"]},"lifetime_volume_usdc":{"type":["number","null"]},"win_rate_pct":{"type":["number","null"]}},"required":["total_pnl","realized_pnl","lifetime_volume_usdc","win_rate_pct"],"additionalProperties":false},"first_trade_at":{"type":["string","null"]},"last_trade_at":{"type":["string","null"]},"locked_metric_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"snapshot_age_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"wallet_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tid":{"type":"string"},"wallet_label":{"type":"string"},"display":{"type":"object","properties":{"username":{"type":["string","null"]},"pseudonym":{"type":["string","null"]},"profile_image":{"type":["string","null"]},"verified":{"type":"boolean"},"founding":{"type":"boolean"}},"required":["username","pseudonym","profile_image","verified","founding"],"additionalProperties":false}},"required":["rank","composite_score","total_pnl","total_pnl_net_fees","realized_pnl","pnl_under_review","lifetime_volume_usdc","trade_count","markets_traded","win_rate_pct","percentiles","first_trade_at","last_trade_at","locked_metric_count","snapshot_age_seconds","tid","wallet_label","display"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-t","summary":"GET /v1/public/t/{tid}"}},"/v1/public/t/{tid}/calibration":{"get":{"tags":["public"],"description":"Reliability diagram for a masked trader id.","parameters":[{"schema":{"type":"string","minLength":20,"maxLength":64},"in":"path","name":"tid","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"bins":{"minItems":10,"maxItems":10,"type":"array","items":{"type":"object","properties":{"bin_idx":{"type":"integer","minimum":0,"maximum":9},"bin_label":{"type":"string"},"predicted_mean":{"type":"number"},"observed_rate":{"type":["number","null"]},"n":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["bin_idx","bin_label","predicted_mean","observed_rate","n"],"additionalProperties":false}},"n_total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tid":{"type":"string"}},"required":["bins","n_total","tid"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-public-t-calibration","summary":"GET /v1/public/t/{tid}/calibration"}},"/v1/t/{tid}/resolve":{"get":{"tags":["public"],"description":"Resolve an opaque trader id to its wallet address. Requires a session.","parameters":[{"schema":{"type":"string","minLength":20,"maxLength":64},"in":"path","name":"tid","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"proxy_wallet":{"type":"string"}},"required":["proxy_wallet"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"feature":{"type":"string"},"field":{"type":"string"},"plan":{"type":"string"},"retry_after_sec":{"type":"number"},"retry_after_seconds":{"type":"number"},"reason":{"type":"string"},"issues":{"type":"array","items":{}},"trace_id":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}},"operationId":"get-t-resolve","summary":"GET /v1/t/{tid}/resolve","security":[{"apiKey":[]},{"sessionCookie":[]}]}},"/v1/public/preset-redirects":{"get":{"tags":["public"],"description":"Leaderboard presets that were merged into another board or retired, and the preset that now serves each slug. GET /v1/rankings/preset/{slug} and GET /v1/public/leaderboard?preset= already serve the target for these slugs.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"redirects":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"from_name":{"type":"string"},"to":{"type":"string"},"reason":{"type":"string","enum":["merged","retired"]}},"required":["from","from_name","to","reason"],"additionalProperties":false}}},"required":["redirects"],"additionalProperties":false}}}}},"operationId":"get-public-preset-redirects","summary":"GET /v1/public/preset-redirects"}},"/v1/public/newsletter/subscribe":{"post":{"tags":["public"],"description":"Subscribe to the weekly Smart-Money Report (double opt-in: a confirmation email is sent).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"]}}}},"responses":{"200":{"description":"Default Response"}},"operationId":"post-public-newsletter-subscribe","summary":"POST /v1/public/newsletter/subscribe"}},"/v1/public/newsletter/confirm":{"get":{"tags":["public"],"description":"Confirm a newsletter subscription (link from the confirmation email).","parameters":[{"schema":{"type":"string","minLength":16,"maxLength":1024},"in":"query","name":"token","required":true}],"responses":{"200":{"description":"Default Response"}},"operationId":"get-public-newsletter-confirm","summary":"GET /v1/public/newsletter/confirm"}},"/v1/public/reports/smart-money":{"get":{"tags":["public"],"description":"Archive of published Weekly Smart-Money Reports (newest first).","parameters":[{"schema":{"default":52,"type":"integer","minimum":1,"maximum":104},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response"}},"operationId":"get-public-reports-smart-money","summary":"GET /v1/public/reports/smart-money"}},"/v1/public/reports/smart-money/{week}":{"get":{"tags":["public"],"description":"One Weekly Smart-Money Report: auto-generated payload + founder intro.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-w\\d{2}$"},"in":"path","name":"week","required":true}],"responses":{"200":{"description":"Default Response"}},"operationId":"get-public-reports-smart-money-2","summary":"GET /v1/public/reports/smart-money/{week}"}},"/v1/agent/catalog":{"get":{"operationId":"agent-get-catalog","summary":"GET /v1/agent/catalog","description":"Free (no payment).","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"security":[],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."}}}},"/v1/agent/compare":{"get":{"operationId":"agent-get-compare","summary":"GET /v1/agent/compare","description":"2–4 traders head-to-head: all metrics + percentiles + per-metric winner + live marks. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"addrs","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":400}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/copy-engine/board":{"get":{"operationId":"agent-get-copy-engine-board","summary":"GET /v1/agent/copy-engine/board","description":"Copy Engine board: the forward-tested copyable wallets with their gates, copyability, depth-capped clip sizes and reasons, for any published day (unmasked, uncapped). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"sleeve","in":"query","required":false,"description":"Which sleeve's eligible wallets: 'a' = positive forward-tested 14d skill score (the default), 'b' = positive 30d in-band copy return, 'any' = either.","schema":{"default":"a","type":"string","enum":["a","b","any"]}},{"name":"sort","in":"query","required":false,"description":"Ordering column. Scores sort descending with NULLs last; signal_freshness_hours (an age) sorts ascending.","schema":{"default":"sk_score_14d","type":"string","enum":["sk_score_14d","inband_return_30d","taker_inband_pnl_14d","signal_freshness_hours"]}},{"name":"limit","in":"query","required":false,"description":"Rows per page, 1-200 (default 50).","schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (pagination); `total` in the response is the eligible-cohort size.","schema":{"default":0,"type":"integer","minimum":0,"maximum":100000}},{"name":"as_of","in":"query","required":false,"description":"A past published day (YYYY-MM-DD), read as it was published. Omit for the latest day. A day the engine did not publish is a 404.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/copy-engine/funnel":{"get":{"operationId":"agent-get-copy-engine-funnel","summary":"GET /v1/agent/copy-engine/funnel","description":"Copy Engine per-gate funnel: wallets remaining after each hard gate for a published day. x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"as_of","in":"query","required":false,"description":"A published day (YYYY-MM-DD). Omit for the latest day. A day the engine did not publish is a 404.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/copy-engine/methodology":{"get":{"operationId":"agent-get-copy-engine-methodology","summary":"GET /v1/agent/copy-engine/methodology","description":"Copy Engine parameters actually in force for a published day (from the run journal), plus gate and metric definitions. x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"as_of","in":"query","required":false,"description":"A published day (YYYY-MM-DD). Omit for the latest day. A day the engine did not publish is a 404.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/credits/balance":{"get":{"operationId":"agent-get-credits-balance","summary":"GET /v1/agent/credits/balance","description":"Prepaid credit balance for the caller wallet (micro-USDC). x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.001,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/credits/deposit":{"post":{"operationId":"agent-post-credits-deposit","summary":"POST /v1/agent/credits/deposit","description":"Prepay USDC credits (authorize the deposit amount; settles in full + volume bonus). Price is a floor. x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/event/{slug}":{"get":{"operationId":"agent-get-event","summary":"GET /v1/agent/event/{slug}","description":"Event (fixture) profile: its questions with mids, fee and resolver facts, neg-risk overround. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Polymarket event slug (lowercase kebab, e.g. 'epl-hul-mun-2026-08-22'). Any event of a fixture resolves the whole fixture; `canonical_slug` in the answer is the fixture's base event.","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]{0,159}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/event/{slug}/traders":{"get":{"operationId":"agent-get-event-traders","summary":"GET /v1/agent/event/{slug}/traders","description":"Who is in an event: top holders, skill-ranked active wallets and smart-money vs crowd flow (unmasked). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"slug","in":"path","required":true,"description":"Polymarket event slug (lowercase kebab, e.g. 'epl-hul-mun-2026-08-22'). Any event of a fixture resolves the whole fixture; `canonical_slug` in the answer is the fixture's base event.","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9][a-z0-9-]{0,159}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/events/top":{"get":{"operationId":"agent-get-events-top","summary":"GET /v1/agent/events/top","description":"Open events ranked by 24h volume, one row per fixture. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"limit","in":"query","required":false,"description":"Events to return, 1-2000, highest 24 h volume first. Default 500.","schema":{"default":500,"type":"integer","minimum":1,"maximum":2000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/identity/{proxy}":{"get":{"operationId":"agent-get-identity","summary":"GET /v1/agent/identity/{proxy}","description":"Multi-wallet identity: the person’s full wallet set + combined per-user metrics. x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.03,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/leaderboard":{"get":{"operationId":"agent-get-leaderboard","summary":"GET /v1/agent/leaderboard","description":"Default/preset top-N board, unmasked; ?sort= orders it by any metric (metric:/pctile:/engine:/timing:). x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.03,"security":[{"x402":[]}],"parameters":[{"name":"preset","in":"query","required":false,"description":"Preset slug (GET /v1/agent/rankings/presets lists them). Default polyrank-default.","schema":{"default":"polyrank-default","type":"string","maxLength":64,"pattern":"^[a-z0-9-]+$"}},{"name":"sort","in":"query","required":false,"description":"Order the preset board by: composite (default), a whitelisted column, metric: / pctile: (any displayable metric), engine: or timing:. NULLs last.","schema":{"type":"string","maxLength":80}},{"name":"dir","in":"query","required":false,"description":"Sort direction (default desc).","schema":{"default":"desc","type":"string","enum":["desc","asc"]}},{"name":"limit","in":"query","required":false,"description":"Rows (max 500).","schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"description":"Row offset.","schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"include_breakdown","in":"query","required":false,"description":"Attach the per-metric percentile breakdown to each row.","schema":{"type":"string","enum":["0","1","true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}":{"get":{"operationId":"agent-get-market","summary":"GET /v1/agent/market/{conditionId}","description":"Market summary (holder average entry + settlement-corrected mid + shallow book). x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/active-traders":{"get":{"operationId":"agent-get-market-active-traders","summary":"GET /v1/agent/market/{conditionId}/active-traders","description":"Wallets active in one market ranked by price-adjusted category edge, plus the pre-registered lean (unmasked). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"description":"Market condition id (0x + 64 hex, any case; answered lowercased).","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"active_hours","in":"query","required":false,"description":"Trailing window, in hours, in which a wallet must have a fill (or hold the market) to be listed, 1-168. Default 48.","schema":{"default":48,"type":"integer","minimum":1,"maximum":168}},{"name":"limit","in":"query","required":false,"description":"Rows to return, 1-200, best-ranked first. Default 50.","schema":{"default":50,"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/concentration":{"get":{"operationId":"agent-get-market-concentration","summary":"GET /v1/agent/market/{conditionId}/concentration","description":"Holder concentration: top-N share + HHI per side + smart-money share of open interest. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/fills":{"get":{"operationId":"agent-get-market-fills","summary":"GET /v1/agent/market/{conditionId}/fills","description":"Recent fills (the tape) for a market. x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/flow":{"get":{"operationId":"agent-get-market-flow","summary":"GET /v1/agent/market/{conditionId}/flow","description":"5-min flow buckets for the trailing window (max 168h). x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"hours","in":"query","required":false,"schema":{"default":24,"type":"integer","minimum":1,"maximum":168}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/flow/cohort":{"get":{"operationId":"agent-get-market-flow-cohort","summary":"GET /v1/agent/market/{conditionId}/flow/cohort","description":"Net YES-equivalent flow split by Polyrank track-record tag (whale/sharp/early_bird/contrarian) vs untagged wallets. No competitor sells this. x402: $0.1 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.1,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"hours","in":"query","required":false,"schema":{"default":24,"type":"integer","minimum":1,"maximum":72}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/holders":{"get":{"operationId":"agent-get-market-holders","summary":"GET /v1/agent/market/{conditionId}/holders","description":"Top current holders with live value + P&L (canonical avg-cost lineage). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/liquidity-history":{"get":{"operationId":"agent-get-market-liquidity-history","summary":"GET /v1/agent/market/{conditionId}/liquidity-history","description":"Liquidity depth over time: daily rollup or 15-min intraday YES-token depth buckets (copyability substrate). x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"granularity","in":"query","required":false,"schema":{"default":"daily","type":"string","enum":["daily","intraday"]}},{"name":"days","in":"query","required":false,"schema":{"default":30,"type":"integer","minimum":1,"maximum":90}},{"name":"hours","in":"query","required":false,"schema":{"default":48,"type":"integer","minimum":1,"maximum":168}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/positioning":{"get":{"operationId":"agent-get-market-positioning","summary":"GET /v1/agent/market/{conditionId}/positioning","description":"Top-200 positioned wallets + Polyrank track-record tags + unrealized P&L. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/prices":{"get":{"operationId":"agent-get-market-prices","summary":"GET /v1/agent/market/{conditionId}/prices","description":"YES price history for one market (1d / 1w / 1m / all). x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"description":"Market condition id (0x + 64 hex, any case; answered lowercased).","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"window","in":"query","required":false,"description":"History window: 1d (15 min buckets), 1w (1 h), 1m (4 h) or all (1 d, coarsened to weeks then months past 500 points; days the order-book tape has no point are drawn from fills, source 'trades'). Default 1w.","schema":{"default":"1w","type":"string","enum":["1d","1w","1m","all"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/recap":{"get":{"operationId":"agent-get-market-recap","summary":"GET /v1/agent/market/{conditionId}/recap","description":"Resolution recap: outcome/provenance, who-called-early, winners/losers, smart-money hit-rate. x402: $0.15 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.15,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/resolution-risk":{"get":{"operationId":"agent-get-market-resolution-risk","summary":"GET /v1/agent/market/{conditionId}/resolution-risk","description":"Dispute-risk score (Low/Elevated/High + reasons) + live UMA settlement state. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/market/{conditionId}/stats":{"get":{"operationId":"agent-get-market-stats","summary":"GET /v1/agent/market/{conditionId}/stats","description":"All-time market aggregate stats (volume, traders, lifespan, top traders). x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"conditionId","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},{"name":"top","in":"query","required":false,"schema":{"default":10,"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/markets/batch":{"post":{"operationId":"agent-post-markets-batch","summary":"POST /v1/agent/markets/batch","description":"Bulk market summaries for up to 100 condition_ids in one call (holder average entry + settlement-corrected mid + resolution). $0.0015/market, capped. x402: $0.15 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.15,"security":[{"x402":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"condition_ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string"}}},"required":["condition_ids"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/metrics/catalog":{"get":{"operationId":"agent-get-metrics-catalog","summary":"GET /v1/agent/metrics/catalog","description":"Free (no payment).","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"security":[],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."}}}},"/v1/agent/metrics/coverage":{"get":{"operationId":"agent-get-metrics-coverage","summary":"GET /v1/agent/metrics/coverage","description":"Per-metric ranked coverage (how many wallets have a percentile) at every window. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/metrics/distribution/{metric}":{"get":{"operationId":"agent-get-metrics-distribution","summary":"GET /v1/agent/metrics/distribution/{metric}","description":"Cohort distribution of one metric (precomputed snapshot). x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"metric","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"window","in":"query","required":false,"schema":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/metrics/windows":{"get":{"operationId":"agent-get-metrics-windows","summary":"GET /v1/agent/metrics/windows","description":"Free (no payment).","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"security":[],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."}}}},"/v1/agent/movers":{"get":{"operationId":"agent-get-movers","summary":"GET /v1/agent/movers","description":"Daily skill-rank climbers/fallers (unmasked). Supports ?since= incremental cursor. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"preset","in":"query","required":false,"schema":{"default":"polyrank-default","type":"string","minLength":1,"maxLength":64}},{"name":"lookback_days","in":"query","required":false,"schema":{"default":7,"type":"integer","minimum":1,"maximum":30}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"since","in":"query","required":false,"schema":{"type":"string","maxLength":32}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/pulse":{"get":{"operationId":"agent-get-pulse","summary":"GET /v1/agent/pulse","description":"Discover feed: holder-entry vs mid + sharp moves + trending markets. Supports ?since=. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/rankings/custom":{"post":{"operationId":"agent-post-rankings-custom","summary":"POST /v1/agent/rankings/custom","description":"Custom composite ranking over the full wallet cohort (weights + filters) — the flagship. x402: $0.2 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.2,"security":[{"x402":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"default":1,"type":"number","const":1},"weights":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"weight":{"type":"number","minimum":0,"maximum":1000,"description":"Relative weight; will be auto-normalized."},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["weight"]}},{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]},"weight":{"type":"number","minimum":0,"maximum":1000}},"required":["metric","weight"]}}]},"filters":{"default":{},"type":"object","properties":{"min_trades":{"type":"integer","minimum":0,"maximum":1000000},"min_volume_usdc":{"type":"number","minimum":0,"maximum":1000000000000},"min_resolved":{"type":"integer","minimum":0,"maximum":1000000},"min_active_days":{"type":"integer","minimum":0,"maximum":10000},"min_realized_pnl":{"description":"Lifetime FIFO cash P&L floor in USDC, GROSS of fees. Set to 0 to exclude losing wallets.","type":"number"},"min_realized_pnl_net_fees":{"description":"Lifetime FIFO cash P&L floor in USDC, NET of the fees the wallet actually paid. This is the honest \"no losing wallets\" gate: the gross floor left 2 of 15 live boards carrying a wallet that lost money after its own fees, worst -$140,483. Prefer this over min_realized_pnl on any board that recommends copying.","type":"number"},"min_profit_factor":{"description":"Profit factor floor (gross profit / gross loss). 1.0 = break-even, > 1 = profitable.","type":"number","minimum":0,"maximum":1000},"min_win_rate_pct":{"description":"Win rate floor in % (resolved positions only). Excludes lucky-spray patterns (0% win rate + occasional big winner). Set to 5 for the default-preset shape.","type":"number","minimum":0,"maximum":100},"max_roi_pct":{"description":"ROI % ceiling. Polymarket's minimum price is 0.1¢ (1000× max payout), so any wallet with ROI > 99,900% likely received CTF shares via ERC1155 Transfer (airdrop/promo) — we cannot account for shares acquired outside fills. Default-preset uses 9900 (100× max payout, conservative).","type":"number"},"since_date":{"description":"ISO-8601 date — only consider wallets first active on/after this date.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"categories":{"type":"array","items":{"type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]}},"market_kinds":{"type":"array","items":{"type":"string","enum":["binary","negrisk"]}},"exchange_versions":{"type":"array","items":{"type":"string","enum":["v1","v2"]}},"exclude_bonders":{"description":"Exclude entries with implied probability > 0.85 — the \"bonder\" arbitrage.","default":false,"type":"boolean"},"smart_money_tags_any_of":{"description":"Require the wallet to carry at least one of these tags. `toxic` is retired (2026-08-21) and matches nothing, but is still accepted for backward compatibility.","type":"array","items":{"type":"string","enum":["whale","sharp","early_bird","contrarian","toxic"]}},"copy_placeable":{"description":"Keep traders where at least min_share_pct% of buy prints are placeable under these copy settings: a fixed $ per copy, a bankroll scaled against the trader's peak or typical capital, or mirroring their size. Passes only what the stored quantiles can show.","type":"object","properties":{"mode":{"type":"string","enum":["fixed","proportional","mirror"]},"clip_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"bankroll_usd":{"type":"number","exclusiveMinimum":0,"maximum":1000000000000},"basis":{"type":"string","enum":["peak","typical"]},"min_share_pct":{"type":"number","minimum":0,"maximum":100}},"required":["mode","min_share_pct"],"additionalProperties":false},"copy_engine":{"description":"Restrict to a copy-engine sleeve (the validated wallet selection). Overrides may only TIGHTEN the engine's own gates.","type":"object","properties":{"sleeve":{"default":"a","type":"string","enum":["a","b","any"]},"max_signal_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_sniper_median_ttr_min":{"type":"number","minimum":30,"maximum":10000},"min_sk_score_14d":{"type":"number"},"min_sk_n_14d":{"type":"integer","minimum":1,"maximum":10000},"max_sniper_share":{"type":"number","minimum":0,"maximum":1},"min_active_days_14d":{"type":"integer","minimum":1,"maximum":14},"require_no_decay":{"type":"boolean"},"max_copyable_freshness_hours":{"type":"number","minimum":0,"maximum":48},"min_entry_depth_usd":{"type":"number","minimum":0,"maximum":1000000000}},"additionalProperties":false},"timing":{"description":"Restrict to wallets with a measured edge in one category AND one entry-timing bucket — the walk-forward-validated selection.","type":"object","properties":{"sub":{"type":"string","minLength":1,"maxLength":64,"description":"Subcategory: a market category, a Sports refinement (Soccer / Baseball / TableTennis / Sports-other), or 'ALL'."},"bucket":{"type":"string","enum":["pregame","pre_gt24h","pre_lt24h","inplay","tr_gt24h","tr_lt24h","all_ex_last30"],"description":"Entry-timing slice. pre_* is measured against kick-off, tr_* against resolution — never merged, because game_start_time is 98.7% covered on Soccer and 16.0% on Politics."},"window":{"default":"14d","type":"string","enum":["14d","90d"]},"min_n":{"type":"integer","minimum":1,"maximum":100000,"description":"Minimum resolved positions in this slice. The report uses 10 at 14d, 30 at 90d."},"min_skill":{"type":"number"},"min_taker_share":{"description":"Floor on n_taker / n_taker_scanned. 0.5 is the \"maker flow — hard to copy\" line: a maker-side record cannot be followed by a taker copier however good it looks.","type":"number","minimum":0,"maximum":1},"min_luck_z":{"type":"number"}},"required":["sub","bucket","min_n"],"additionalProperties":false},"history_board":{"description":"A Strategy Lab history board's latest seat (preset-only; ranked by the seat's own order, no weights).","type":"object","properties":{"board":{"type":"string","enum":["underdog-specialists","copier-consensus","predictors-early-underdog","sports-closing-line"]}},"required":["board"],"additionalProperties":false},"cluster_policy":{"description":"Wallet-farm policy: \"any\" (default), \"one_per_cluster\" (keep the top-ranked member of each farm), or \"exclude_clustered\" (drop clustered wallets entirely).","type":"string","enum":["any","exclude_clustered","one_per_cluster"]},"follower_count_max":{"description":"Hidden-gems filter: cap follower count.","type":"integer","minimum":0,"maximum":9007199254740991},"active_within_days":{"description":"Only wallets whose last trade is within this many days — surface currently-active traders. Compiles against `last_trade_at`, which is a MIDNIGHT-TRUNCATED DATE (P1-6): all 3.1M rows carry one distinct time-of-day, so this gate is a FLOOR, not a lag. For sub-day precision use active_within_hours, which reads the live fills table instead.","type":"integer","minimum":1,"maximum":3650},"active_within_hours":{"description":"Only wallets with a real fill in the last N hours, read live from poly.wallet_fills (a fill counts once indexed; no nightly lag). ANDed with active_within_days — narrows, never widens. Max 168 (7d); beyond a week the day-grain filter is the cheaper instrument.","type":"integer","minimum":1,"maximum":168},"first_trade_within_days":{"description":"Only wallets whose FIRST trade is within this many days — surface newer accounts (Rising Sharps).","type":"integer","minimum":1,"maximum":3650},"max_volume_usdc":{"description":"Lifetime volume ceiling — for \"hidden gems\" / small-footprint filtering.","type":"number","minimum":0,"maximum":1000000000000},"skill_gates":{"description":"Require the wallet to be in the top (100 − min_pctile)% of each metric, at the metric's window (default lifetime; set window:\"30d\"/\"90d\" for recency gates). Powers \"gate on skill, then rank by profit\" — every preset shows only traders who are genuinely skilled on its dimension.","maxItems":8,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min_pctile":{"type":"number","minimum":0,"maximum":100},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric","min_pctile"]}},"best_category":{"description":"Only wallets whose strongest (best-calibrated) category is this one — e.g. \"best Sports/Politics/Crypto traders\".","type":"string","enum":["Crypto","Stocks","Sports","Tennis","Esports","Politics","World","Weather","Pop Culture","Tech","Finance","Mentions"]},"metric_filters":{"description":"Raw-value range gates on any displayable metric at its window (default lifetime; set window:\"30d\"/\"90d\" for recency filters like \"profitable in the last month\"). Absolute, vs skill_gates which are relative top-X%. NULL semantics: a filter on metric X only keeps wallets where X is measured — unmeasured (NULL/NaN) wallets are excluded (min_profit_factor is the one legacy NULL-passes exception). A windowed filter also excludes wallets with no activity in the window (via the auto min-n floor).","maxItems":12,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"min":{"type":"number"},"max":{"type":"number"},"window":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},"required":["metric"]}}},"additionalProperties":false},"na_policy":{"default":"exclude","type":"string","enum":["exclude","neutral_50"]},"preset_id":{"default":null,"type":["string","null"]},"created_via_preset_id":{"default":null,"type":["string","null"]},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"include_breakdown":{"default":false,"type":"boolean"},"include_verdict":{"default":false,"type":"boolean"},"extra_metrics":{"maxItems":60,"type":"array","items":{"type":"string"}},"extra_engine_metrics":{"maxItems":12,"type":"array","items":{"type":"string"}},"include_raw":{"default":false,"type":"boolean"},"sort_by":{"default":"composite","type":"string","maxLength":80},"sort_dir":{"default":"desc","type":"string","enum":["desc","asc"]},"explain":{"default":false,"type":"boolean"},"include_cluster":{"default":false,"type":"boolean"},"dedupe_clusters":{"default":false,"type":"boolean"},"c19_cap":{"type":"number","minimum":0,"maximum":1000000},"as_of":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["weights"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/rankings/goals":{"get":{"operationId":"agent-get-rankings-goals","summary":"GET /v1/agent/rankings/goals","description":"Free (no payment).","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"security":[],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."}}}},"/v1/agent/rankings/preset/{slug}":{"get":{"operationId":"agent-get-rankings-preset","summary":"GET /v1/agent/rankings/preset/{slug}","description":"Top-N for a named Polyrank preset (same full-cohort scan as custom; fixed weights). x402: $0.04 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.04,"security":[{"x402":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":64,"pattern":"^[a-z0-9-]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"include_breakdown","in":"query","required":false,"description":"true / false / 1 / 0","schema":{"type":"string","enum":["0","1","true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/rankings/presets":{"get":{"operationId":"agent-get-rankings-presets","summary":"GET /v1/agent/rankings/presets","description":"List of Polyrank preset ranking slugs + labels. x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.001,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/rankings/published/{slug}":{"get":{"operationId":"agent-get-rankings-published","summary":"GET /v1/agent/rankings/published/{slug}","description":"A user-published custom ranking by its public slug. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":128,"pattern":"^[a-z0-9-]+$"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":10000}},{"name":"include_breakdown","in":"query","required":false,"description":"true / false / 1 / 0","schema":{"type":"string","enum":["0","1","true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/reports/smart-money":{"get":{"operationId":"agent-get-reports-smart-money","summary":"GET /v1/agent/reports/smart-money","description":"Curated weekly smart-money report (movers, big wins, holder entry vs mid, calibration leader). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":52,"type":"integer","minimum":1,"maximum":104}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/reports/smart-money/{week}":{"get":{"operationId":"agent-get-reports-smart-money","summary":"GET /v1/agent/reports/smart-money/{week}","description":"Curated smart-money report for a specific ISO week. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"week","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{4}-w\\d{2}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/resolutions":{"get":{"operationId":"agent-get-resolutions","summary":"GET /v1/agent/resolutions","description":"Since-cursor feed of on-chain market resolutions, for mechanical settlement. x402: $0.01 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.01,"security":[{"x402":[]}],"parameters":[{"name":"cursor","in":"query","required":false,"description":"Opaque keyset cursor from a previous response's next_cursor (pages forward over (resolved_block, log_index)). Mutually exclusive with since_updated_at.","schema":{"type":"string","minLength":1}},{"name":"since_updated_at","in":"query","required":false,"description":"ISO-8601 timestamp: rows whose INGESTION time (updated_at) is at or after it, ordered by updated_at — the sweep that catches backfilled / re-org-corrected rows a block cursor already passed. Mutually exclusive with cursor.","schema":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},{"name":"limit","in":"query","required":false,"description":"Rows per page, 1-1000 (default 200).","schema":{"default":200,"type":"integer","minimum":1,"maximum":1000}},{"name":"binary_only","in":"query","required":false,"description":"true = only binary (2-outcome) conditions, the ones a simple copy bot settles. Accepts true/false/1/0.","schema":{"type":"string","enum":["0","1","true","false"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/search":{"get":{"operationId":"agent-get-search","summary":"GET /v1/agent/search","description":"Universal resolver: username / market text / 0x / condition_id → traders + markets. x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.001,"security":[{"x402":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"limit","in":"query","required":false,"schema":{"default":8,"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/signals/smart-money":{"get":{"operationId":"agent-get-signals-smart-money","summary":"GET /v1/agent/signals/smart-money","description":"Recent smart-money signal events. Supports ?since= cursor (incremental → $0.02 effective). x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"hours","in":"query","required":false,"schema":{"default":24,"type":"integer","minimum":1,"maximum":168}},{"name":"limit","in":"query","required":false,"schema":{"default":500,"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/stats":{"get":{"operationId":"agent-get-stats","summary":"GET /v1/agent/stats","description":"Platform totals: wallets, trades, markets, live metric count, since year. x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.001,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}":{"get":{"operationId":"agent-get-trader","summary":"GET /v1/agent/trader/{proxy}","description":"Trader profile + lifetime metrics + percentiles (richer than a generic address summary). x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}},{"name":"budget","in":"query","required":false,"schema":{"type":"number","exclusiveMinimum":0,"maximum":1000000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/activity":{"get":{"operationId":"agent-get-trader-activity","summary":"GET /v1/agent/trader/{proxy}/activity","description":"Unified activity feed: BUY/SELL fills, REDEEM settlements, Split/Merge/Convert — paged. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"description":"Polymarket proxy wallet address (0x + 40 hex, any case; answered checksummed).","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"all | trade (BUY/SELL fills) | settlement (REDEEM of held winning shares) | other (Split/Merge/Convert).","schema":{"default":"all","type":"string","enum":["all","trade","settlement","other"]}},{"name":"limit","in":"query","required":false,"description":"Rows per page, 1-200. Default 50.","schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (newest first), 0-200000.","schema":{"default":0,"type":"integer","minimum":0,"maximum":200000}},{"name":"scope","in":"query","required":false,"description":"'combined' merges the feed of every wallet of the user; default 'wallet'.","schema":{"type":"string","enum":["combined","wallet"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/calibration":{"get":{"operationId":"agent-get-trader-calibration","summary":"GET /v1/agent/trader/{proxy}/calibration","description":"Calibration: Brier + 10-bin reliability diagram (the skilled-vs-lucky verdict). No competitor equivalent. x402: $0.15 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.15,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/copy-fitness":{"get":{"operationId":"agent-get-trader-copy-fitness","summary":"GET /v1/agent/trader/{proxy}/copy-fitness","description":"Curated copy-decision bundle: hold-time, entry price, taker share, clip distribution, traded-market liquidity, verdict + budget-fit at ?budget=. x402: $0.1 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.1,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}},{"name":"budget","in":"query","required":false,"schema":{"default":100,"type":"number","exclusiveMinimum":0,"maximum":1000000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/metrics":{"get":{"operationId":"agent-get-trader-metrics","summary":"GET /v1/agent/trader/{proxy}/metrics","description":"Every metric displayable at ?window= (lifetime/90d/30d/7d/24h) for one trader: raw value + percentile in that window's cohort — the cells a windowed board ranks on. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"description":"Proxy wallet address (0x + 40 hex; any case).","schema":{"type":"string"}},{"name":"window","in":"query","required":false,"description":"Metric window. GET /v1/agent/metrics/windows lists which metrics exist at each.","schema":{"default":"lifetime","type":"string","enum":["lifetime","90d","30d","7d","24h"]}},{"name":"scope","in":"query","required":false,"description":"combined (default): the multi-wallet user row when boards rank users, as a board row is; wallet: this wallet only.","schema":{"default":"combined","type":"string","enum":["combined","wallet"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/playbook":{"get":{"operationId":"agent-get-trader-playbook","summary":"GET /v1/agent/trader/{proxy}/playbook","description":"Trader Playbook: best categories, stake buckets, entry timing, sizing, co-traders. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/pnl-curve":{"get":{"operationId":"agent-get-trader-pnl-curve","summary":"GET /v1/agent/trader/{proxy}/pnl-curve","description":"Equity / realized-P&L curve over time (avg-cost-faithful, validated to the cent). x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.03,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}},{"name":"window","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/position-changes":{"get":{"operationId":"agent-get-trader-position-changes","summary":"GET /v1/agent/trader/{proxy}/position-changes","description":"Per-token entry/increase/decrease/exit CHANGE events since a cursor (copy-trade poll). Supports ?wallets=a,b,c (max 10) at the same flat price; each change carries proxy_wallet. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":200,"type":"integer","minimum":1,"maximum":1000}},{"name":"wallets","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/positions":{"get":{"operationId":"agent-get-trader-positions","summary":"GET /v1/agent/trader/{proxy}/positions","description":"Open/closed positions + live unrealized mark (the \"am I in sync?\" reconciliation call). x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.03,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"default":"open","type":"string","enum":["open","closed","all"]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":200000}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/predictor":{"get":{"operationId":"agent-get-trader-predictor","summary":"GET /v1/agent/trader/{proxy}/predictor","description":"Predictor card: prediction accuracy, closed win rate, held-to-resolution share, luck-adjusted edge z, biggest win/loss, worst day. x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.03,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"description":"Polymarket proxy wallet address (0x + 40 hex, any case; answered checksummed).","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"Default 'combined' (as GET /v1/trader/:proxy). One wallet of a multi-wallet user under 'wallet' answers status 'unavailable', reason 'wallet_scope': the stats are built per user.","schema":{"type":"string","enum":["combined","wallet"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/return-distribution":{"get":{"operationId":"agent-get-trader-return-distribution","summary":"GET /v1/agent/trader/{proxy}/return-distribution","description":"Histogram of returns over EVERY resolved position, with the bucketed and the unscorable count. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"description":"Polymarket proxy wallet address (0x + 40 hex, any case; answered checksummed).","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"'combined' buckets the union of the user's resolved positions (user_condition_realized); default 'wallet'.","schema":{"type":"string","enum":["combined","wallet"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/tags":{"get":{"operationId":"agent-get-trader-tags","summary":"GET /v1/agent/trader/{proxy}/tags","description":"Smart-money skill tags for one wallet (prediction-market-scoped). x402: $0.03 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.03,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/timing-skill":{"get":{"operationId":"agent-get-trader-timing-skill","summary":"GET /v1/agent/trader/{proxy}/timing-skill","description":"Category × entry-timing skill grid (shrunken skill, n, rankable flag, best cell, timing profile) — the pre-game / in-play specialist signal. x402: $0.05 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.05,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"description":"Polymarket proxy wallet address (0x + 40 hex, any case; answered checksummed).","schema":{"type":"string"}},{"name":"window","in":"query","required":false,"description":"Lookback window of the skill grain: 14d (rankable floor n >= 10) or 90d (n >= 30). Default 14d.","schema":{"default":"14d","type":"string","enum":["14d","90d"]}},{"name":"scope","in":"query","required":false,"description":"'combined' takes, per cell, the member wallet with the most positions (scores are ratios and are never summed); default 'wallet'.","schema":{"type":"string","enum":["combined","wallet"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trader/{proxy}/trades":{"get":{"operationId":"agent-get-trader-trades","summary":"GET /v1/agent/trader/{proxy}/trades","description":"Paginated fill history (cursor) with skill context — core copy-trade data. Supports ?since= (unix s/ms or ISO-8601) and ?side=maker|taker|both. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"proxy","in":"path","required":true,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"side","in":"query","required":false,"schema":{"default":"both","type":"string","enum":["maker","taker","both"]}},{"name":"since","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/traders/batch":{"post":{"operationId":"agent-post-traders-batch","summary":"POST /v1/agent/traders/batch","description":"Bulk score up to 100 wallets in one call (metrics + percentiles + tags). $0.0015/wallet, capped. x402: $0.15 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.15,"security":[{"x402":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"proxies":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string"}}},"required":["proxies"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/traders/recently-active":{"get":{"operationId":"agent-get-traders-recently-active","summary":"GET /v1/agent/traders/recently-active","description":"Most profitable traders (by our metrics) who just traded: 5m–24h windows, unmasked, sortable by any metric (lifetime|30d). Activity is minutes-grain live; metric values are grid cadence. Supports ?since= incremental cursor. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"default":"1h","type":"string","enum":["5m","15m","1h","6h","24h"]}},{"name":"sort","in":"query","required":false,"schema":{"default":"realized_pnl","type":"string","maxLength":48}},{"name":"sort_window","in":"query","required":false,"schema":{"default":"lifetime","type":"string","enum":["lifetime","30d"]}},{"name":"sort_dir","in":"query","required":false,"schema":{"default":"desc","type":"string","enum":["asc","desc"]}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},{"name":"since","in":"query","required":false,"schema":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/trades/top-roi":{"get":{"operationId":"agent-get-trades-top-roi","summary":"GET /v1/agent/trades/top-roi","description":"Highest-ROI resolved trades, UNMASKED real wallets + exact ROI. x402: $0.02 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.02,"security":[{"x402":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"category","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"subcategory","in":"query","required":false,"schema":{"type":"string","enum":["aapl","abnb","ai","american-football","amsterdam","amzn","ankara","atlanta","atp","auckland","austin","awards","baseball","basketball","beijing","big-tech","bitcoin","bnb","boxing","buenos-aires","busan","call-of-duty","cape-town","celebrities","chengdu","chess","chicago","chongqing","climate","coin","commodities","counter-strike","creators","cricket","cycling","dallas","darts","davis-cup","dax","denver","dji","dogecoin","dota-2","ea-sports-fc","earnings","earthquakes","economy","equities","ethereum","fed-rates","ftse","gaming","geopolitics","global-elections","golf","googl","guangzhou","handball","helsinki","hockey","hong-kong","honor-of-kings","hood","houston","hsi","hurricanes","hype","inflation","ipos","istanbul","itf","jeddah","karachi","kuala-lumpur","lacrosse","laver-cup","league-of-legends","london","los-angeles","lucknow","madrid","manila","memecoins","meta","mexico-city","miami","middle-east","milan","mma","mobile-legends","moscow","motorsport","movies","msft","mu","munich","music","natural-disasters","new-york-city","nflx","nik","nvda","nya","open","overwatch","panama-city","paris","pickleball","pltr","poker","pubg","qingdao","rainbow-six-siege","regulation","rklb","rocket-league","rugby","rut","san-francisco","sao-paulo","science","seattle","seoul","shanghai","shenzhen","singapore","soccer","solana","space","spx","starcraft","table-tennis","taipei","tel-aviv","tennis","token-launches","tokyo","toronto","treasuries","trump","tsla","tv","tweets","ukraine-russia","us-elections","us-politics","valorant","volleyball","warsaw","wta","wuhan","xrp","zcash","zhengzhou"]}},{"name":"subtype","in":"query","required":false,"schema":{"type":"string","enum":["15m","1h","4h","5m","afc-champions-league","argentina-primera","atp","ballon-dor","brazil-serie-a","bundesliga","bundesliga-2","cfb","cfl","college-basketball","concacaf-nations-league","daily","denmark-superliga","efl-championship","efl-cup","epl","eredivisie","euroleague","f1","fa-cup","highest-temperature","indycar","international-cricket","international-friendlies","ipl","j1-league","j2-league","k-league","kbo","khl","la-liga","la-liga-2","libertadores","liga-mx","ligue-1","liv-golf","lowest-temperature","lpga","mlb","mls","monthly","motogp","nascar","nba","nfl","nhl","npb","nwsl","pga","precipitation","primeira-liga","saudi-pro-league","serie-a","sudamericana","super-lig","ucl","uecl","uefa-nations-league","uel","ufc","ufl","uwcl","weekly","wnba","world-cup","world-cup-qualifiers","yearly"]}},{"name":"since_days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":3650}},{"name":"sort","in":"query","required":false,"schema":{"default":"roi","type":"string","enum":["roi","profit","cost","entry","recency"]}},{"name":"dir","in":"query","required":false,"schema":{"default":"desc","type":"string","enum":["desc","asc"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/webhooks":{"get":{"operationId":"agent-get-webhooks","summary":"GET /v1/agent/webhooks","description":"List the caller wallet’s webhook subscriptions (management; payer wallet = identity). x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.001,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}},"post":{"operationId":"agent-post-webhooks","summary":"POST /v1/agent/webhooks","description":"Register an agent-owned webhook subscription (trader.fill / market.resolved / signal.smart_money). x402: $0.005 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.005,"security":[{"x402":[]}],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_url":{"type":"string","pattern":"^https:\\/\\/"},"event_types":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["trader.fill","market.resolved","signal.smart_money"]}},"filter_json":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["target_url","event_types"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/webhooks/{id}":{"delete":{"operationId":"agent-delete-webhooks","summary":"DELETE /v1/agent/webhooks/{id}","description":"Deactivate one of the caller wallet’s webhook subscriptions. x402: $0.001 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.001,"security":[{"x402":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}},"/v1/agent/ws-token":{"post":{"operationId":"agent-post-ws-token","summary":"POST /v1/agent/ws-token","description":"Mint a short-TTL WebSocket token (x402-authorized) to open the live trade/market firehose. x402: $0.005 per call, settled in USDC only on a 2xx — a 4xx is free.","tags":["agent"],"servers":[{"url":"https://api-agent.polyrank.app"}],"x-price-usd":0.005,"security":[{"x402":[]}],"parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request — refused before payment settles (free)."},"402":{"description":"Payment required: the body carries the x402 PaymentRequirements (price, asset, network, payTo)."}}}}},"servers":[{"url":"https://api.polyrank.app"}],"tags":[{"name":"agent","description":"Pay-per-request agent rail at api-agent.polyrank.app — no account, USDC on Base via x402, settled only on a 2xx. Same ranking request as POST /v1/rankings/custom.","x-displayName":"x402 Agent API"},{"name":"alerts","description":"","x-displayName":"alerts"},{"name":"api_keys","description":"Mint, list, and revoke pk_live_… API keys (session auth only).","x-displayName":"API keys"},{"name":"auth","description":"Sign-in flows (SIWE, magic link, Turnkey) and WSS token minting.","x-displayName":"Auth"},{"name":"compare","description":"Side-by-side trader comparison.","x-displayName":"Compare"},{"name":"copy-engine","description":"","x-displayName":"copy-engine"},{"name":"feedback","description":"","x-displayName":"feedback"},{"name":"follows","description":"","x-displayName":"follows"},{"name":"lab","description":"","x-displayName":"lab"},{"name":"market","description":"Market consensus, positioning, holders, flow, fills, and stats.","x-displayName":"Markets"},{"name":"meta","description":"","x-displayName":"meta"},{"name":"metrics","description":"Metric definitions and population distributions.","x-displayName":"Metrics catalog"},{"name":"profile","description":"","x-displayName":"profile"},{"name":"public","description":"Anonymous teaser namespace — free, cached, no API key required.","x-displayName":"Public (no auth)"},{"name":"push","description":"","x-displayName":"push"},{"name":"rankings","description":"Preset leaderboards and the custom Ranking Builder.","x-displayName":"Rankings"},{"name":"redeem","description":"","x-displayName":"redeem"},{"name":"referral","description":"","x-displayName":"referral"},{"name":"resolutions","description":"","x-displayName":"resolutions"},{"name":"search","description":"Universal search across traders and markets.","x-displayName":"Search"},{"name":"stats","description":"Aggregate platform totals.","x-displayName":"Platform stats"},{"name":"trader","description":"Per-wallet skill profiles, trades, positions, calibration, P&L curve, playbook.","x-displayName":"Traders"},{"name":"user","description":"","x-displayName":"user"},{"name":"webhooks","description":"Webhook subscription CRUD, signing, and test deliveries.","x-displayName":"Webhooks"}]},"proxyUrl":"$undefined"},"document":"./openapi/polyrank.json","operations":[{"method":"get","path":"/v1/agent/catalog","tags":"$116:props:children:2:props:children:props:payload:bundled:paths:/v1/agent/catalog:get:tags"}],"showDescription":true}]}]]}]

GET /v1/agent/catalog

Response Body

200application/json

400

`application/json`