Create Market Order

The Pacifica Python SDK provides a comprehensive example on using this endpoint.

Request

{
  "id": "660065de-8f32-46ad-ba1e-83c93d3e3966",
  "params": {
    "create_market_order": {
      "account": "AwX6321...",
      "signature": "5vnYpt...",
      "timestamp": 1749223025396,
      "expiry_window": 5000,
      "symbol": "BTC",
      "reduce_only": false,
      "amount": "0.001",
      "side": "bid",
      "slippage_percent": "0.5",
      "client_order_id": "79f948fd-7556-4066-a128-083f3ea49322",
      "builder_code": "MYCODE"
    }
  }
}

Field	Type	Need	Description	Example
`”id”`	Full UUID string	required	Client-defined request ID	`660065de-8f32-46ad-ba1e-83c93d3e3966`
`”params”`	object	required	Contains action type and action parameters	`”create_order"`
`"create_market_order”`	object	required	Specifies action type and contains parameters	See examples.
`”account”`	string	required	User’s wallet address	`42trU9A5…`
`“agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”symbol”`	string	required	Trading pair symbol	`BTC`
`”reduce_only”`	boolean	required	Whether the order is reduce-only	`false`
`”amount”`	string	required	Order amount	`0.1`
`”side”`	string	required	Order side (bid/ask)	`bid`
`”slippage_percent”`	string	required	Maximum allowed slippage in percentage, e.g. “0.5” means 0.5% max slippage	`0.5`
`”client_order_id”`	Full UUID string	optional	Client-defined order ID	`f47ac10b-58cc-4372-a567-0e02b2c3d479`
`”builder_code”`	string	optional	Builder program code (3-16 alphanumeric)	`MYCODE`
`”take_profit”`	object	optional	Take profit stop order configuration	See next three rows
`”stop_price”`	string	required (if `“take_profit”` exists)	Stop trigger price	`55000`
`”limit_price”`	string	optional	Limit price for the triggered order	`54950`
`”client_order_id”`	Full UUID string	optional	Client-defined order ID for the stop order	`e36ac10b-58cc-4372-a567-0e02b2c3d479`
`”trigger_price_type”`	string	optional	Price type to trigger stop. Options: `mark_price` (default), `last_trade_price`, `mid_price`	`mark_price`
`”stop_loss”`	object	optional	Stop loss order configuration	See next three rows
`”stop_price”`	string	required (if `“stop_loss”` exists)	Stop trigger price	`48000`
`”limit_price”`	string	optional	Limit price for the triggered order	`47950`
`”client_order_id”`	Full UUID string	optional	Client-defined order ID for the stop order	`d25ac10b-58cc-4372-a567-0e02b2c3d479`
`”trigger_price_type”`	string	optional	Price type to trigger stop. Options: `mark_price` (default), `last_trade_price`, `mid_price`	`mark_price`

Response

{
  "code": 200,
  "data": {
    "I": "79f948fd-7556-4066-a128-083f3ea49322",
    "i": 645953,
    "s": "BTC"
  },
  "id": "660065de-8f32-46ad-ba1e-83c93d3e3966",
  "t": 1749223025962,
  "type": "create_market_order",
  "rl": {
    "r": 9990,
    "q": 10000,
    "t": 1000
  }
}

Field	Type	Description
`'code'`	integer	Status code
`'data'`	object	Contains information about placed order
`'I'`	string	CLOID (if provided)
`'i'`	integer	Order ID
`'s'`	string	Symbol
`'id'`	string	Client-defined request ID
`'t'`	integer	Timestamp in milliseconds
`'type'`	string	Specifies action type
`'rl'`	object or null	Rate-limit info, always present: `r` = credits remaining, `q` = quota, `t` = reset-in (ms)

On error, the frame omits data and instead carries an err (string) field describing the failure, alongside the same id, type, code, t, and rl fields. Note: In order to protect liquidity providers from adverse selection, all market orders are subject to a ~200ms delay.

​Request

​Response

Request

Response