Skip to main content
POST
/
api
/
sdk
/
copytrading
/
execute
Copytrading Execute
curl --request POST \
  --url https://api.simmer.markets/api/sdk/copytrading/execute \
  --header 'Content-Type: application/json' \
  --data '
{
  "wallets": [
    "<string>"
  ],
  "top_n": 123,
  "max_usd_per_position": 50,
  "dry_run": false,
  "buy_only": true,
  "detect_whale_exits": false,
  "max_trades": 123,
  "venue": "<string>"
}
'
{
  "success": true,
  "wallets_analyzed": 123,
  "positions_found": 123,
  "conflicts_skipped": 123,
  "top_n_used": 123,
  "trades_needed": 123,
  "trades_executed": 123,
  "trades": [
    {
      "market_id": "<string>",
      "market_title": "<string>",
      "action": "<string>",
      "side": "<string>",
      "shares": 123,
      "estimated_price": 123,
      "estimated_cost": 123,
      "success": true,
      "error": "<string>"
    }
  ],
  "summary": "<string>",
  "markets_matched": 0,
  "user_positions": 0,
  "trades_filtered_buy_only": 0,
  "buys_skipped_min_shares": 0,
  "buys_skipped_min_value": 0,
  "whale_exits_detected": 0,
  "failed_markets_skipped": 0,
  "drift_filtered": 0,
  "stale_filtered": 0,
  "low_conviction_positions": 0,
  "errors": []
}
This endpoint executes real trades. Always test with venue=sim first.

Body

application/json

Request for copytrading execute endpoint.

​
wallets
string[]
required
​
top_n
integer | null
​
max_usd_per_position
number
default:50
​
dry_run
boolean
default:false
​
buy_only
boolean
default:true
​
detect_whale_exits
boolean
default:false
​
max_trades
integer | null
​
venue
string | null

Response

Successful Response

Response from copytrading execute endpoint.

​
success
boolean
required
​
wallets_analyzed
integer
required
​
positions_found
integer
required
​
conflicts_skipped
integer
required
​
top_n_used
integer
required
​
trades_needed
integer
required
​
trades_executed
integer
required
​
trades
SDKCopytradingTradeResult · object[]
required
​
summary
string
required
​
markets_matched
integer
default:0
​
user_positions
integer
default:0
​
trades_filtered_buy_only
integer
default:0
​
buys_skipped_min_shares
integer
default:0
​
buys_skipped_min_value
integer
default:0
​
whale_exits_detected
integer
default:0
​
failed_markets_skipped
integer
default:0
​
drift_filtered
integer
default:0
​
stale_filtered
integer
default:0
​
low_conviction_positions
integer
default:0
​
errors
string[]