Place a trigger order
create_orderPlace a resting order that executes later when its condition is met: a limit order, take-profit, stop-loss, trigger buy, or a DCA schedule. ⚠️ THIS SPENDS REAL MONEY. It submits a real transaction from the user's wallet using real funds and cannot be undone. Confirm the exact amount, token and network with the user in plain language, and get their explicit go-ahead, BEFORE calling this. It commits the user's funds to a trade that can fire while they are not looking. Read back the full order — type, token, amount, every price — and get an explicit yes before calling.
Trade limits: a SELL order (TP, SL, limit or DCA sell into the USD stable) never counts toward or is blocked by maxTradeUsd / dailyVolumeUsd. A BUY order is checked against both and reserves its USD value in the daily volume when placed; if it is cancelled, expires or fails, the unfilled part is given back.
order_type selects what to place, and which price arguments are required:
limit_buy— buy when the price falls tolimit_price. Needslimit_price.amountis the amount of the FUNDING asset to spend.limit_sell— sell when the price rises tolimit_price. Needslimit_price.amountis the amount of the held token to sell.tp_only— take profit: sell when the price rises totake_profit_price. Needstake_profit_price.sl_only— stop loss: sell when the price falls tostop_loss_price. Needsstop_loss_price.trigger_buy— buy when the price DROPS to the trigger. The trigger goes instop_loss_price; no other price.amountis the FUNDING asset to spend.sl_and_tp— a BRACKET: stop loss AND take profit on one position in ONE call. Needsstop_loss_priceandtake_profit_price;amountis the held token, and both legs cover it (whichever fires first sells it). It places TWO orders, a stop loss and a take profit: the result saysorder_type: "sl_and_tp"and lists them inlegs(order_id+order_typeeach; alsostop_loss_order_id/take_profit_order_id). When one fills, Moby cancels the other. If ONE leg could not be placed,failed_legsays which andfailed_leg_errorwhy — the other leg is LIVE and stays; place only the missing one withsl_only/tp_only, never the bracket again.To protect a position on BOTH sides use
sl_and_tp, ortp_onlyandsl_onlyas two calls (back to back is fine). Cancelling one leg does NOT cancel the other. When one FILLS and that sells the whole position, Moby cancels your remaining exits on that token within a minute or two (a fullquick_sellcancels them in the same call); after a PARTIAL exit the other stays live.get_my_orders(status="terminal") then shows it withcancel_reason.dca_buy/dca_sell— split the trade intoorder_countequal slicesinterval_secondsapart. Needs both, and NO price argument. All prices are USD prices of the token.amountis always what the user SPENDS: the funding asset on a buy, the token itself on a sell. Refusals that are NOT argument problems:no_market(no sell route for a new token yet — wait and retry the same call later) andstop_above_market/tp_below_market(price already past the trigger — re-check the price and pick a new trigger). Deciding to retry or re-place is your job; Moby does not retry or re-arm for you. To CLOSE or trim a position at market now, usequick_sell— not an order here. EXITS ARE YOURS: Moby attaches no automatic TP/SL to your buys. Place a position's take-profit / stop-loss here (sl_and_tp, ortp_only/sl_only) after the buy. SOL positions: use quick_sell; TP/SL on SOL is not supported yet.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | How much to SPEND, in whole token units: the funding asset on a buy, the held token on a sell. | |
| network | No | solana | |
| rationale | No | Optional. Your 2–4 line thesis: why this coin, why now, who's in it, what breaks it. Stored with the trade and shown to the user; ≤500 chars. | |
| order_type | Yes | Which kind of order to place. See the tool description for what each one needs. | |
| limit_price | No | USD limit price. Required for `limit_buy` and `limit_sell`. | |
| order_count | No | How many DCA slices to split the amount into. Required for `dca_buy` and `dca_sell`. | |
| token_address | Yes | Contract address of the token the order is about. | |
| stop_loss_price | No | USD price at which to stop out. Required for `sl_only` and `sl_and_tp`; for `trigger_buy` it is the price the buy fires at when the price drops to it. | |
| interval_seconds | No | Seconds between DCA slices. Required for `dca_buy` and `dca_sell`. | |
| take_profit_price | No | USD price at which to take profit. Required for `tp_only` and `sl_and_tp`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||