close_futures_position
ActiveTool of CoinRithm Agent Trading
Close or partially reduce a mock futures position. fraction in (0,1] reduces partially; omit (or 1) for a full close. idempotencyKey is REQUIRED. Requires the trade:futures scope. 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": [
"positionId",
"idempotencyKey"
],
"properties": {
"fraction": {
"type": "number",
"maximum": 1,
"description": "(0,1] portion to close; omit/1 = full close.",
"exclusiveMinimum": 0
},
"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
},
"positionId": {
"type": "integer",
"description": "Open futures position id to close or reduce.",
"exclusiveMinimum": 0
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"description": "Unique per close intent; reuse replays the original result."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
CoinRithm Agent Trading
https://github.com/CoinRithm/coinrithm-agent-trading
1/7 registries