create_order
PREPARE TXMCP + HTTP + SDK1 CALL
Create a conditional order — limit, stop-loss, take-profit or recurring buy. Tradient watches the condition and, when it is met, sends the user a ready-to-sign transaction (via webhook and the dashboard). Orders can be cancelled any time.
Parameters
All parameters are sent as a JSON object.
typestringOrder type.
sidestringbuy or sell.
tokenstringToken ticker or address.
walletstringThe user's wallet address (0x…). Transactions are prepared for this wallet to sign.
amountUsd?numberFor buys: USD (USDG) to spend each time.
sellPercent?numberFor sells: percent of the position to sell (1-100).
below?numberTrigger when price is at or below this USD level.
above?numberTrigger when price is at or above this USD level.
dropPct?numberTrigger when price falls this percent from now.
risePct?numberTrigger when price rises this percent from now.
every?stringFor recurring: interval like 1d or 1w.
capUsd?numberFor recurring: total budget in USD.
expiresIn?stringOptional expiry like 7d or 24h.
Example request
Through MCP your AI sends the arguments below. Over HTTP, POST them to /api/v1/tools/create_order.
create_order({ "type": "stop_loss", "side": "sell", "token": "KITTY", "dropPct": 25, "wallet": "0x…" })Example response
Prepare tools return unsigned transactions for the user's wallet. Nothing executes until it is signed.
{
"orderId": "…",
"summary": "Sell 100% of KITTY if it falls 25%",
"status": "active"
}Notes
Tradient checks active orders every minute. When an order triggers, a ready-to-sign transaction appears in the dashboard and is posted to your webhook.
Fully automatic execution through ERC-4337 session keys is on the roadmap.