place_spot_order
ActiveTool of CoinRithm Agent Trading
Place a paper spot order. coinId is a coin UCID, NOT a ticker. orderType market/limit/stop. limitPrice required for limit & stop; stopPrice required for stop. idempotencyKey is REQUIRED and unique per intent (reuse replays the original result — retry a timed-out call with the SAME key; it will never double-execute). Requires the trade:spot scope. CONFIRM with the user before calling. 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": [
"coinId",
"side",
"orderType",
"quantity",
"idempotencyKey"
],
"properties": {
"side": {
"enum": [
"buy",
"sell"
],
"type": "string",
"description": "Spot side: buy spends USDT; sell spends the base coin."
},
"coinId": {
"type": "string",
"description": "Coin UCID (e.g. \"1\" = BTC)."
},
"quantity": {
"type": "number",
"description": "Base-coin amount (> 0).",
"exclusiveMinimum": 0
},
"orderType": {
"enum": [
"market",
"limit",
"stop"
],
"type": "string",
"description": "Order execution type: market, limit, or stop."
},
"stopPrice": {
"type": "number",
"description": "USD trigger — required for stop.",
"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
},
"limitPrice": {
"type": "number",
"description": "USD/coin — required for limit & stop.",
"exclusiveMinimum": 0
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"description": "Unique per intent; reuse replays the original result."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
CoinRithm Agent Trading
https://github.com/CoinRithm/coinrithm-agent-trading
1/7 registries