Place & Cancel Orders (Signed)

POST

order

curl --request POST \
  --url https://mainnet-api1.bulk.trade/api/v1/order \
  --header 'Content-Type: application/json' \
  --data '
{
  "actions": [
    {
      "l": {
        "c": "BTC-USD",
        "b": true,
        "px": 100000,
        "sz": 0.1,
        "tif": "GTC",
        "r": false,
        "i": false
      }
    }
  ],
  "nonce": 1704067200000,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s...base58..."
}
'

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [
        {
          "resting": {
            "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F"
          }
        }
      ]
    }
  }
}

4 October 2026 upgrade: the new ALO_SLIDE / ALO_JOIN modes, resting-price alignment, and conditional slippage options below apply after the scheduled upgrade. Only resting ALO/post-only orders are scheduled to be cleared. GTC and already-placed conditional orders remain. Untriggered on-fill actions attached to a cleared ALO order are removed with that parent order.

All order operations use the unified POST /order endpoint. Send a transaction with an actions array; each action is a tagged object (e.g. {"l": {...}} for a limit order).

See Transaction Signing for how to sign requests. Use a unique nonce (e.g. nanoseconds): BigInt(Date.now()) * 1_000_000n.

Transaction Envelope

Every request to POST /order has this shape:

{
  "actions": [Action, ...],
  "nonce": 1704067200000,
  "account": "base58_pubkey",
  "signer": "base58_pubkey",
  "signature": "base58_signature"
}

Field	Description
`actions`	Array of action objects (see below). Order/cancel/modify use `l`, `m`, `mod`, `cx`, `cxa`, `st`, `tp`, `rng`, `trig`, `trl`, `of`; builder-code approval uses `abc`/`rbc`.
`nonce`	Unique value for replay protection (e.g. timestamp in nanoseconds).
`account`	Account public key (base58); whose account is traded. Set this to a sub-account pubkey to trade on a sub-account, with its master (or an agent wallet authorized on either) as `signer`.
`signer`	Signer public key (base58); who is signing. Either the `account` itself, or an authorized agent wallet registered on the `account` (or on the parent master when `account` is a sub-account).
`signature`	Ed25519 signature (base58).

Optional Request Header

POST /order accepts an optional x-bulk-sig-mode: raw | offchain | base58 header that hints which signature verifier path to try first. The header is a hint only; signature validity still decides accept/reject. Omit it for the default raw canonical-binary path. See Offchain Signing Mode.

Trading on a sub-account: every action on this page (orders, modify, cancel, conditional baskets, on-fill) works on a sub-account exactly the same way. Just set account to the sub-account pubkey while its master (or an authorized agent wallet) signs. See Sub-Accounts: Trading From a Sub-Account.

Isolated Account Routing (`i`)

Order actions that produce a position (l, m, st, tp, rng, trl) carry a required i boolean. When i = true, the order is routed into a per-instrument isolated account under the signing account instead of its base account. A trig basket has no top-level i; each nested action controls its own routing. Isolated accounts are managed entirely through this flag; they are never set as account on a transaction.

{"l": {"c": "BTC-USD", "b": true, "px": 100000.0, "sz": 0.1, "tif": "GTC", "r": false, "i": true}}

Behaviour:

The isolated account is auto-derived from the signing account and the instrument; no separate “create” call is required. The protocol attaches it under the signing master/sub-account on first use.
Resulting fills, positions, fees, and risk live on the isolated account, not the base account. Isolated-account rows in account snapshots and history carry iso = true and expose the isolated account’s pubkey as isoPubkey.
A liquidation on the isolated account only touches that account’s margin. The signing master/sub-account is unaffected.
Top up isolated-account margin by sending a transfer action with to = isoPubkey. This is the only place an isolated-account pubkey is used directly. See Transfer.
Set i = false to keep base-account routing.

For full conceptual background and lifecycle, see Isolated Margin.

Builder Codes

Builder codes are optional routed-order fees and only belong on the routed m or l order. Use abc once to approve a recipient, then include the builderCode payload on the order sent through that builder.

{"abc": {"to": "recipient_pubkey_base58", "fee": 5}}

{"m": {"c": "BTC-USD", "b": true, "sz": 0.1, "r": false, "i": false, "builderCode": {"to": "recipient_pubkey_base58", "fee": 5}}}

Rules:

fee is basis points and must be 1..=15.
Each master account can approve at most 10 recipients. A recipient must be an existing canonical root payout account and cannot be the signer, its root, or another account in the same account tree.
Orders without a builder code omit the field entirely. "builderCode": null is rejected by the JSON API.
In canonical signing bytes, an absent builderCode contributes no bytes; a present value contributes the Some tag (1), recipient pubkey, and fee.
The builder-code fee applies only to the side whose order carried builderCode, whether that side later fills as maker or taker.
abc and rbc must be signed by the master account. Agent wallets cannot approve or revoke builder-code recipients. Account snapshots expose approved builder-code recipients as builderCodeApprovals: [{ "recipient": "...", "maxFee": 5 }].
Revoking with rbc prevents later builder-code fee settlement for resting orders that have not filled yet.

{"rbc": {"to": "recipient_pubkey_base58"}}

See Builder Codes for builder-facing behavior and Transaction Signing for binary encoding.

Place Limit Order (`l`)

GTC (Good Till Cancel)

Standard limit order that rests on the book.

{
  "actions": [
    {"l": {"c": "BTC-USD", "b": true, "px": 100000.0, "sz": 0.1, "tif": "GTC", "r": false, "i": false}}
  ],
  "nonce": 1704067200000,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7sVt3k2YxPqH4w..."
}

IOC (Immediate or Cancel)

Fills immediately or cancels the unfilled portion.

{"l": {"c": "BTC-USD", "b": true, "px": 105000.0, "sz": 0.1, "tif": "IOC", "r": false, "i": false}}

ALO (Add Liquidity Only / Post-Only)

Maker only; rejected if it would cross the spread.

{"l": {"c": "BTC-USD", "b": true, "px": 99000.0, "sz": 0.1, "tif": "ALO", "r": false, "i": false}}

ALO Slide and ALO Join

ALO_SLIDE moves a crossing order to the most aggressive non-crossing display tick. ALO_JOIN moves a crossing order to the same-side best quote; if there is no same-side quote, it falls back to Slide. A non-crossing order keeps its tick-aligned submitted price. Both modes remain post-only and are still subject to the usual risk and order-validity checks.

{"l": {"c": "BTC-USD", "b": true, "px": 100000.0, "sz": 0.1, "tif": "ALO_SLIDE", "r": false, "i": false}}

{"l": {"c": "BTC-USD", "b": true, "px": 100000.0, "sz": 0.1, "tif": "ALO_JOIN", "r": false, "i": false}}

Use these action objects inside the signed transaction’s actions array for HTTP or WebSocket submissions. JSON uses the uppercase names; 3 and 4 are their binary signing enum indices, not JSON request values. Existing indices remain GTC = 0, IOC = 1, and ALO = 2. Account/order updates use postOnlySlide and postOnlyJoin respectively. GET /exchangeInfo advertises uppercase names in timeInForces.

Resting Price Alignment

Orders capable of resting (GTC and the ALO family) align to the market’s pricePrecision / tickSize: buy prices round down and sell prices round up. IOC prices retain native fixed-point precision. For Slide/Join, read the order’s reported working price rather than assuming it equals the submitted price. Read sizeDecimals and sizeIncrement from GET /exchangeInfo for quantity precision. The increment is not a minimum trade notional; minNotional still applies.

With Builder Code

{"l": {"c": "BTC-USD", "b": true, "px": 100000.0, "sz": 0.1, "tif": "GTC", "r": false, "i": false, "builderCode": {"to": "recipient_pubkey_base58", "fee": 5}}}

Limit Order Fields

Field	Type	Description
`c`	string	Symbol (e.g. “BTC-USD”)
`b`	boolean	`true` = buy, `false` = sell
`px`	number	Limit price
`sz`	number	Size/quantity
`tif`	string	Time in force: `"GTC"`, `"IOC"`, `"ALO"`, `"ALO_SLIDE"`, `"ALO_JOIN"`
`r`	boolean	Reduce-only
`i`	boolean	Required. `true` routes the order into the per-instrument isolated account under the signing account; `false` keeps base-account routing.
`builderCode`	object	Optional builder-code fee payload `{to, fee}`. `fee` is 1..15 bps and must be approved with `abc`. Omit when absent; do not send `null`.

Place Market Order (`m`)

Executes at best available price immediately. An optional slippage override is expressed in basis points. When omitted, the market’s configured default applies. This bounds permitted execution; it does not guarantee a fill.

{
  "actions": [
    {"m": {"c": "BTC-USD", "b": true, "sz": 0.1, "r": false, "i": false}}
  ],
  "nonce": 1704067200001,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7sVt3k2YxPqH4w..."
}

With builder code:

{"m": {"c": "BTC-USD", "b": true, "sz": 0.1, "r": false, "i": false, "builderCode": {"to": "recipient_pubkey_base58", "fee": 5}}}

Field	Type	Description
`c`	string	Symbol
`b`	boolean	`true` = buy, `false` = sell
`sz`	number	Size/quantity
`r`	boolean	Reduce-only
`i`	boolean	Required. `true` routes the order into the per-instrument isolated account under the signing account; `false` keeps base-account routing.
`builderCode`	object	Optional builder-code fee payload `{to, fee}`. `fee` is 1..15 bps and must be approved with `abc`. Omit when absent; do not send `null`.

Conditional Slippage Overrides

Market-executing stop (st), take-profit (tp), and trailing (trl) actions accept an optional slippage value in basis points. Range (rng) actions use independent slSlippage and tpSlippage values for their stop-loss and take-profit legs. When absent, the applicable security default is used. A limit-executing leg continues to use its explicit limit price. Use the updated SDK’s signing implementation for conditional actions and batches that contain them: the conditional slippage fields participate in canonical signing even when an override is omitted. Do not merely append a JSON field to a transaction signed with an older conditional-action encoder.

Modify Order (`mod`)

Change the size of an existing resting order.

{
  "actions": [
    {"mod": {"oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F", "symbol": "BTC-USD", "amount": 0.05}}
  ],
  "nonce": 1704067200008,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Type	Description
`oid`	string	Order ID (base58 hash)
`symbol`	string	Symbol
`amount`	number	New order size

Cancel Single Order (`cx`)

Cancel a specific order by ID.

{
  "actions": [
    {"cx": {"c": "BTC-USD", "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F"}}
  ],
  "nonce": 1704067200002,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Description
`c`	Symbol
`oid`	Order ID to cancel (base58)

Cancel All Orders (`cxa`)

Cancel all in one symbol

{"cxa": {"c": ["BTC-USD"]}}

Cancel all across all symbols

{"cxa": {"c": []}}

Field	Description
`c`	Array of symbols; use `[]` to cancel all symbols.

Batch Actions

Send multiple actions in one transaction (e.g. cancel + place).

{
  "actions": [
    {"cx": {"c": "BTC-USD", "oid": "old_order_hash_base58"}},
    {"l": {"c": "BTC-USD", "b": true, "px": 99000.0, "sz": 0.05, "tif": "GTC", "r": false, "i": false}},
    {"l": {"c": "BTC-USD", "b": false, "px": 101000.0, "sz": 0.05, "tif": "GTC", "r": false, "i": false}}
  ],
  "nonce": 1704067200007,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Stop Order (`st`)

Place a conditional stop order that triggers when price crosses a threshold.

{
  "actions": [
    {"st": {"c": "BTC-USD", "d": false, "sz": 0.25, "tr": 98000.0, "lim": 97950.0, "i": false}}
  ],
  "nonce": 1704067200011,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Type	Description
`c`	string	Symbol
`d`	boolean	Trigger direction (`true` = above/equal, `false` = below/equal)
`sz`	number	Size to execute on trigger
`tr`	number	Trigger threshold price
`lim`	number?	Optional limit price after trigger. Omit for market-style
`i`	boolean	Required. `true` routes the triggered order into the per-instrument isolated account under the signing account; `false` keeps base-account routing.

Take Profit Order (`tp`)

Place a conditional take-profit order.

{
  "actions": [
    {"tp": {"c": "BTC-USD", "d": true, "sz": 0.25, "tr": 104000.0, "lim": 103950.0, "i": false}}
  ],
  "nonce": 1704067200012,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Same fields as Stop Order (st).

Range / OCO Order (`rng`)

Place a range collar (one-cancels-the-other stop + take-profit pair).

{
  "actions": [
    {"rng": {"c": "BTC-USD", "d": true, "sz": 0.5, "pmin": 96000.0, "pmax": 106000.0, "lmin": 95950.0, "lmax": 105950.0, "i": false}}
  ],
  "nonce": 1704067200013,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Type	Description
`c`	string	Symbol
`d`	boolean	Position direction (`true` = long collar, `false` = short)
`sz`	number	Size to protect/exit
`pmin`	number	Lower trigger threshold
`pmax`	number	Upper trigger threshold
`lmin`	number?	Optional limit for lower trigger leg
`lmax`	number?	Optional limit for upper trigger leg
`i`	boolean	Required. `true` routes the triggered legs into the per-instrument isolated account under the signing account; `false` keeps base-account routing.

Trigger Basket (`trig`)

Place a trigger that executes a list of actions when threshold is crossed.

{
  "actions": [
    {"trig": {"c": "BTC-USD", "d": true, "tr": 105000.0, "actions": [
      {"m": {"c": "BTC-USD", "b": true, "sz": 0.1, "r": false, "i": false}},
      {"cx": {"c": "BTC-USD", "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F"}}
    ]}}
  ],
  "nonce": 1704067200014,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Type	Description
`c`	string	Symbol
`d`	boolean	Trigger direction (`true` = above/equal, `false` = below/equal)
`tr`	number	Trigger threshold
`actions`	Action[]	Actions executed when trigger fires

The trigger basket itself has no i; each nested order or conditional action controls its own isolated routing. Nested actions support: m, l, mod, cx, cxa, st, tp, rng, trl.

Trailing Stop (`trl`)

Place a trailing conditional that adjusts with favorable price movement.

{
  "actions": [
    {"trl": {"c": "BTC-USD", "b": true, "sz": 0.25, "trb": 100, "stb": 10, "lim": null, "i": false}}
  ],
  "nonce": 1704067200015,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Type	Description
`c`	string	Symbol
`b`	boolean	Protected position direction (`true` = long, `false` = short)
`sz`	number	Size to protect/exit
`trb`	integer	Trailing distance in bps
`stb`	integer	Favorable reset step in bps
`lim`	number?	Optional limit price. `null` for market-style trigger
`i`	boolean	Required. `true` routes trailing execution into the per-instrument isolated account under the signing account; `false` keeps base-account routing.

On-Fill (`of`)

{
  "actions": [
    {"of": {
      "trigger": {
        "l": {"c": "BTC-USD", "b": true, "px": 100000.0, "sz": 0.25, "tif": "GTC", "r": false, "i": false}
      },
      "actions": [
        {"st": {"c": "BTC-USD", "d": false, "sz": 0.25, "tr": 98000.0, "lim": null, "i": false}}
      ]
    }}
  ],
  "nonce": 1704067200016,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s..."
}

Field	Type	Description
`trigger`	Action	Embedded parent action whose first fill activates the plan
`actions`	Action[]	One-shot consequents executed on the trigger action’s first fill

trigger must contain exactly one m or l action. Builder codes work on an embedded trigger or consequent m / l exactly as they do on a top-level order. Nested actions support: m, l, mod, cx, cxa, st, tp, rng, trig, trl.

Cancelling conditional orders: Use cx with the conditional order ID or cxa to cancel all orders including conditionals.

Response Format

All submissions return an OrderResponse with one status per execution event:

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [Status, ...]
    }
  }
}

Size fields in responses (totalSz, filledSz, remainingSz) are signed: negative values indicate sell-side. For example, a fully-filled sell of 0.1 BTC returns totalSz: -0.1.

Authentication failures are returned as HTTP 200 with status: "error" and statuses: [{"error":{"message":"bad signature"}}] or statuses: [{"error":{"message":"unauthorized signer"}}].

Non-Terminal (order still active)

Status	Description	Fields
`resting`	Order placed and resting on book	`{oid}`
`working`	Partial fills, still resting	`{oid, filledSz, remainingSz, vwap}`
`triggered`	Conditional root fired	`{oid}`

Terminal (order complete)

Status	Description	Fields
`filled`	Order fully filled	`{oid, totalSz, avgPx}`
`partiallyFilled`	Partially filled and terminal	`{oid, totalSz, avgPx}`
`cancelled`	Cancelled by user	`{oid}`
`cancelledRiskLimit`	Cancelled - risk limit	`{oid, reason?}`
`cancelledSelfCrossing`	Cancelled - self-crossing (STP)	`{oid}`
`cancelledReduceOnly`	Cancelled - would not reduce position	`{oid}`
`cancelledIoc`	IOC expired without full fill	`{oid, filledSz}`
`rejectedCrossing`	Post-only rejected for crossing	`{oid}`
`rejectedDuplicate`	Duplicate order ID	`{oid}`
`rejectedRiskLimit`	Rejected - risk limit	`{oid, reason?}`
`rejectedInvalid`	Invalid parameters	`{oid, reason?}`
`siblingCancelled`	OCO sibling auto-cancelled	`{oid}`
`triggerFailed`	Trigger execution failed	`{oid, reason?}`
`deposit`	Faucet deposit succeeded	`{amount}`
`depositFailed`	Faucet deposit failed	`{message}`
`agentWallet`	Agent wallet registered	`{agentWallet}`
`agentWalletFailed`	Agent wallet failed	`{message}`
`transfer`	Margin transfer succeeded. See Transfer	`{from, to, symbol, amount}`
`transferFailed`	Margin transfer failed	`{message}`
`createSubAccount`	Sub-account created. See Sub-Accounts	`{master, sub, name, margin}`
`createSubAccountFailed`	Sub-account creation failed	`{message}`
`removeSubAccount`	Sub-account removed	`{account, marginMoved}`
`removeSubAccountFailed`	Sub-account removal failed	`{message}`
`cancelOneRejected`	Cancel rejected	`{oid, reason}`
`cancelAllRejected`	Cancel all rejected	`{reason}`
`error`	Generic error	`{message}`

Response Examples

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{"resting": {"oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F"}}]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{
        "working": {
          "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F",
          "filledSz": -0.05,
          "remainingSz": -0.05,
          "vwap": 100000.0
        }
      }]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{
        "filled": {
          "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F",
          "totalSz": 0.1,
          "avgPx": 100025.5
        }
      }]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{
        "filled": {
          "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F",
          "totalSz": -0.1,
          "avgPx": 100025.5
        }
      }]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{"triggered": {"oid": "9nU4oRhHQkIGY8wOrBTiypn1irpd07GiWeBC7Go6RSj9"}}]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{"siblingCancelled": {"oid": "DEF..."}}]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{"triggerFailed": {"oid": "GHI...", "reason": "conditional execution failed: no counterparty"}}]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{"cancelled": {"oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F"}}]
    }
  }
}

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [{"error": {"message": "Insufficient margin"}}]
    }
  }
}

Headers

x-bulk-sig-mode

enum<string>

Optional signature-mode hint. Hint only - signature validity still decides accept/reject. Omit to use the default raw canonical-binary verification path. Set to offchain when the transaction was signed using the v0 Solana offchain envelope.

Available options:

raw,

offchain,

base58

Body

application/json

Unified signed transaction. All state-mutating operations use this model.

The actions array can contain any combination of action types, executed atomically.

Must be signed - see Transaction Signing for signing details.

actions

required

Array of actions to execute atomically. Each action is a tagged object where the key is the compact action tag.

Action types: l, m, mod, cx, cxa, st, tp, rng, trig, trl, of, faucet, agentWalletCreation, abc, rbc, updateUserSettings, createSubAccount, removeSubAccount, renameSubAccount, transfer, whitelistFaucet (admin), px (admin), o (admin)

Tagged action object. Each action type is an externally tagged enum using compact action tags.

Limit order (l)
Market order (m)
Modify order (mod)
Cancel order (cx)
Cancel all (cxa)
Stop (st)
Take profit (tp)
Range / OCO (rng)
Trigger basket (trig)
Trailing stop (trl)
On-fill (of)
Faucet (faucet)
Agent wallet (agentWalletCreation)
Approve builder-code recipient (abc)
Revoke builder-code recipient (rbc)
Update user settings (updateUserSettings)
Whitelist faucet (admin)
Oracle price (px, admin)
Pyth oracle batch (o, admin)
Create sub-account (createSubAccount)
Remove sub-account (removeSubAccount)
Rename sub-account (renameSubAccount)
Transfer (transfer)

Show child attributes

nonce

integer<int64>

required

Unique nonce for replay protection (use timestamp in nanoseconds or incrementing counter)

account

string

required

Account public key (base58) whose account is being acted on. Must be a master pubkey or a sub-account pubkey. Per-instrument isolated accounts are managed implicitly via the i flag on order actions and are never set as account.

Example:

"FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"

signer

string

required

Signer public key (base58); who is signing. One of:

the account itself;
when account is a sub-account: the parent master, or an agent wallet registered on the parent master (automatically authorized for its sub-accounts);
an agent wallet registered directly on account.

Example:

"FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"

signature

string

required

Ed25519 signature of wincode_serialize(commission_signable_actions) + nonce_le_u64 + account + signature_domain_u8, where mainnet=1, testnet=2, and devnet=3 (base58)

Example:

"5j7sVt3k2YxPqH4w..."

Response

Transaction response.

Note: authentication failures are returned as HTTP 200 with status: "error" and statuses: [{"error":{"message":"bad signature"}}] or statuses: [{"error":{"message":"unauthorized signer"}}].

Transaction accepted. One status per execution event in response.data.statuses.

Response from POST /order. One entry in response.data.statuses per execution event (e.g. one per order placed, or one for faucet/agent/settings). Status variants: resting, working, filled, partiallyFilled, cancelled, cancelledRiskLimit, cancelledSelfCrossing, cancelledReduceOnly, cancelledIoc, rejectedCrossing, rejectedDuplicate, rejectedRiskLimit, rejectedInvalid, deposit, depositFailed, agentWallet, agentWalletFailed, cancelOneRejected, cancelAllRejected, triggered, siblingCancelled, triggerFailed, transfer, transferFailed, createSubAccount, createSubAccountFailed, removeSubAccount, removeSubAccountFailed, renameSubAccount, renameSubAccountFailed, error.

status

enum<string>

required

Top-level status (ok when request was accepted; check each item in statuses for per-action result)

Available options:

ok,

error

response

object

required

Show child attributes

curl --request POST \
  --url https://mainnet-api1.bulk.trade/api/v1/order \
  --header 'Content-Type: application/json' \
  --data '
{
  "actions": [
    {
      "l": {
        "c": "BTC-USD",
        "b": true,
        "px": 100000,
        "sz": 0.1,
        "tif": "GTC",
        "r": false,
        "i": false
      }
    }
  ],
  "nonce": 1704067200000,
  "account": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signer": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "signature": "5j7s...base58..."
}
'

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [
        {
          "resting": {
            "oid": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F"
          }
        }
      ]
    }
  }
}

Getting Started

Market Data (HTTP)

Account (HTTP - Unsigned)

Trading (HTTP - Signed)

Testnet

WebSocket API

Place & Cancel Orders (Signed)

Transaction Envelope

Optional Request Header

Isolated Account Routing (`i`)

Builder Codes

Place Limit Order (`l`)

GTC (Good Till Cancel)

IOC (Immediate or Cancel)

ALO (Add Liquidity Only / Post-Only)

ALO Slide and ALO Join

Resting Price Alignment

With Builder Code

Limit Order Fields

Place Market Order (`m`)

Conditional Slippage Overrides

Modify Order (`mod`)

Cancel Single Order (`cx`)

Cancel All Orders (`cxa`)

Cancel all in one symbol

Cancel all across all symbols

Batch Actions

Stop Order (`st`)

Take Profit Order (`tp`)

Range / OCO Order (`rng`)

Trigger Basket (`trig`)

Trailing Stop (`trl`)

On-Fill (`of`)

Response Format

Non-Terminal (order still active)

Terminal (order complete)

Response Examples

Headers

Body

Response

​Transaction Envelope

​Optional Request Header

​Isolated Account Routing (i)

​Builder Codes

​Place Limit Order (l)

​GTC (Good Till Cancel)

​IOC (Immediate or Cancel)

​ALO (Add Liquidity Only / Post-Only)

​ALO Slide and ALO Join

​Resting Price Alignment

​With Builder Code

​Limit Order Fields

​Place Market Order (m)

​Conditional Slippage Overrides

​Modify Order (mod)

​Cancel Single Order (cx)

​Cancel All Orders (cxa)

​Cancel all in one symbol

​Cancel all across all symbols

​Batch Actions

​Stop Order (st)

​Take Profit Order (tp)

​Range / OCO Order (rng)

​Trigger Basket (trig)

​Trailing Stop (trl)

​On-Fill (of)

​Response Format

​Non-Terminal (order still active)

​Terminal (order complete)

​Response Examples

Headers

Body

Response

Transaction Envelope

Optional Request Header

Isolated Account Routing (`i`)

Builder Codes

Place Limit Order (`l`)

GTC (Good Till Cancel)

IOC (Immediate or Cancel)

ALO (Add Liquidity Only / Post-Only)

ALO Slide and ALO Join

Resting Price Alignment

With Builder Code

Limit Order Fields

Place Market Order (`m`)

Conditional Slippage Overrides

Modify Order (`mod`)

Cancel Single Order (`cx`)

Cancel All Orders (`cxa`)

Cancel all in one symbol

Cancel all across all symbols

Batch Actions

Stop Order (`st`)

Take Profit Order (`tp`)

Range / OCO Order (`rng`)

Trigger Basket (`trig`)

Trailing Stop (`trl`)

On-Fill (`of`)

Response Format

Non-Terminal (order still active)

Terminal (order complete)

Response Examples