get_positions
ActiveTool of CoinRithm Agent Trading
List open + historical positions for a venue. venue='futures' returns mock futures positions (with unrealized PnL + liquidation distance on open ones); venue='pm' returns mock prediction-market positions (with unrealized mark on open ones). Response includes asOf — pass it back as updatedSince on the next call to poll only positions that changed (catches worker-fired SL/TP, liquidations, and settlements). Paper trading only — virtual funds (50,000 mUSD). Not financial advice. Paper fills apply a disclosed execution cost folded into realized PnL: spot/futures pay a taker fee (spot market orders also pay half-spread + slippage); PM fills at the ask with size-based slippage and a Polymarket-shaped taker fee, with entryProbability kept at the mid for calibration. See the executionModel in quote/trade results — a rehearsal cost, not an exchange fill guarantee.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"venue"
],
"properties": {
"venue": {
"enum": [
"futures",
"pm"
],
"type": "string",
"description": "Which venue's positions to list."
},
"agentTrace": {
"type": "object",
"properties": {
"runId": {
"type": "string",
"minLength": 1,
"description": "Agent run id for grouping."
},
"confidence": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Optional confidence score from 0 to 1."
},
"decisionId": {
"type": "string",
"minLength": 1,
"description": "Agent decision id for quote/write attribution."
},
"strategyLabel": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Short strategy label, self-reported by the caller."
},
"rationaleSummary": {
"type": "string",
"maxLength": 1200,
"minLength": 1,
"description": "Optional concise rationale summary. Do not include chain-of-thought, secrets, or account identity."
}
},
"description": "Optional private trace metadata stored in the caller's ledger.",
"additionalProperties": false
},
"updatedSince": {
"type": "string",
"description": "ISO 8601 cursor: only positions whose row changed since this instant. Pass the previous response's asOf back here."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
CoinRithm Agent Trading
https://github.com/CoinRithm/coinrithm-agent-trading
1/7 registries