// Sells or merges tokens from an open alphapoly position via CLOB or on-chain merge. Use when exiting, cleaning up, or managing an open position. Also use when the user says "sell", "close position", "cash out", "redeem", "exit", "clear tokens", or wants to get out of a trade.
| name | Exiting an Alphapoly Position |
| description | Sells or merges tokens from an open alphapoly position via CLOB or on-chain merge. Use when exiting, cleaning up, or managing an open position. Also use when the user says "sell", "close position", "cash out", "redeem", "exit", "clear tokens", or wants to get out of a trade. |
http://localhost:8000GET /positions (or ?state=active to filter)position_id| Situation | Action |
|---|---|
| Exit a live position | Sell — token_type: "wanted" |
| Clear failed entry leftovers | Sell — token_type: "unwanted" |
| Market resolved, hold both outcomes | Merge |
State is pending | Retry |
state: "complete"# Sell a side
POST /positions/{id}/sell
{"side": "target", "token_type": "wanted"}
# Merge resolved pair
POST /positions/{id}/merge
{"side": "target"}
# Retry pending
POST /positions/{id}/retry
# Check result
GET /positions/{id}
When entering, the system splits USDC into YES+NO tokens and sells the side you don't want via CLOB to recover partial cost.
"wanted" — the token you hold as your position (normal exit)"unwanted" — residual from a failed or partial entry sell (cleanup)GET /positions # find position_id
POST /positions/{id}/sell # {"side":"target","token_type":"wanted"}
POST /positions/{id}/sell # {"side":"cover","token_type":"wanted"}
GET /positions/{id} # confirm state == "complete"
If unwanted balances remain after entry: POST /positions/{id}/retry
If market resolved and holding both outcomes:
POST /positions/{id}/merge # {"side":"target"}
POST /positions/{id}/merge # {"side":"cover"}
For full response schemas and error codes, see api-reference.md.
These operations involve real tokens on Polygon — sells are irreversible once the CLOB order fills, and merges burn tokens permanently.
GET /positions) before acting — never guess a position_idfilled: false, surface it — the user still holds the tokensExecutes a covered pair trade (target + cover) on Polymarket with estimate, confirmation, and position recording. Use when entering a new position from a detected portfolio opportunity. Also use when the user says "buy", "trade", "open a position", "place an order", "enter", or wants to act on any portfolio opportunity.
Scaffolds a standalone experiment script in experiments/ using shared backend dependencies. Use when creating a new experiment or prototype outside the main backend. Also use when the user says "prototype", "try something", "test an idea", "spike", "scratch script", "quick experiment", or wants to explore something without modifying the main codebase.
Guides feature development in the alphapoly codebase following stack conventions (uv, polars, FastAPI+Next.js). Use whenever adding, building, or modifying any feature — including new API endpoints, pipeline steps, UI pages, WebSocket services, or any other backend/frontend work. If the user says "add X", "build X", "implement X", "make X work", "create an endpoint", "wire up", "hook up", or "connect X to Y", use this skill. For quick prototypes, consider alphapoly-experiment instead.
Runs, debugs, and manages the alphapoly ML pipeline with make commands and model overrides. Use when running, resetting, or troubleshooting the pipeline. Also use when the user says "refresh data", "update portfolios", "fetch markets", "reprocess", "run the pipeline", or wants to regenerate portfolio opportunities from scratch.
Fetches and displays current hedging portfolio opportunities from the backend API. Use when browsing or listing portfolio opportunities to trade. Also use when the user says "show me opportunities", "what's available", "what can I trade", "show pairs", "list portfolios", "any good trades", or asks about current market opportunities.