Orderly Network

This is a reference for the verification API’s payload adapter. For apps you can use inside a Desk, see Desk apps.

venue: orderly. Over HTTP, orderlynetwork, orderlyperps and woofipro also resolve to it.

What to send

The body of the Orderly request you are about to sign. Symbols use Orderly’s format, such as PERP_ETH_USDC.

`actionType`	Request and body	`actionFamily`
`create-order`	`POST /v1/order`: `{symbol, order_type, side, order_price?, order_quantity or order_amount, reduce_only?, margin_mode?, visible_quantity?, slippage?}`	`order`
`edit-order`	`PUT /v1/order`: the same fields plus `order_id`	`order`
`batch-create-order`	`POST /v1/batch-order`: `{orders: [...]}`	`order`
`create-algo-order`	`POST /v1/algo/order`: `{symbol, algo_type, ...}`	`order`
`cancel-order`	`{symbol, order_id}` or `{symbol, client_order_id}`	`order`
`batch-cancel-orders`	`{order_ids}`, as an array or a comma-separated string	`order`
`update-leverage`	`POST /v1/client/leverages`: `{leverage, symbol?, margin_mode?}`	`margin`
`update-margin-mode`	`POST /v1/client/margin_mode`: `{symbol, default_margin_mode}`	`margin`
`position-margin`	`POST /v1/position_margin`: `{symbol, type: "ADD" or "REDUCE", amount}`	`margin`
`withdraw-request`	`POST /v1/withdraw_request`: `{message: {withdrawNonce, ...}, signature, userAddress, verifyingContract}`	`withdrawal`
`internal-transfer`	`POST /v1/internal_transfer`: a wallet-signed `{message: {transferNonce, ...}}`, or `{token, receiver_list}`	`transfer`
`settle-pnl`	`POST /v1/settle_pnl`: `{message: {settleNonce, ...}, ...}`	`position`

All are detected without venue except a leverage change that has neither symbol nor margin_mode.

Live lookup

For create-order, edit-order, create-algo-order and update-leverage, the adapter calls GET https://api.orderly.org/v1/public/info/{symbol} and GET https://api.orderly.org/v1/public/futures/{symbol}. It adds the symbol’s status, mark price and maximum leverage, and prices a MARKET order at the mark. It flags:

A symbol that is not ACTIVE.
A limit price more than 20% from the mark price.
A price off the symbol’s tick or a quantity off its step.
Notional below the symbol’s minimum.
Leverage above the symbol’s maximum, which the venue caps.

The timeout is 3.5 seconds and results are cached for 5 minutes. An unresolved symbol gets a note to treat the market and the order’s size as unverified and lean ESCALATE.

Notes the classifier adds

Sizes are in the base asset (order_quantity: 0.5 on PERP_ETH_USDC is 0.5 ETH). order_amount is quote-denominated.
A leverage change with no symbol sets leverage for every symbol on the account. Leverage must be an integer from 1 to 100.
REDUCE on position margin pulls margin out of an isolated position and raises its liquidation risk.
visible_quantity: 0 hides the order from the book.
A STOP algo order becomes a market order at the trigger. A STOP or BRACKET entry that is not reduce-only can open exposure. A trailing stop’s callbackRate of 0.1 means 10%.
An edit can raise the quantity, and with it the notional.
Withdrawal and wallet-signed transfer amounts are raw token units; USDC is also shown in dollars at 6 decimals. allowCrossChainWithdraw: true can add a cross-chain fee.
Internal transfer recipients are opaque Orderly account ids, so the note tells the judge to lean ESCALATE when your rules restrict destinations.

Example

const action = {
  symbol: "PERP_ETH_USDC",
  order_type: "LIMIT",
  order_price: 1700,
  order_quantity: 0.5,
  side: "BUY",
  reduce_only: false,
};

const res = await fetch("https://harness.chance.cc/api/v1/intent", {
  method: "POST",
  headers: { "x-api-key": process.env.CHANCE_API_KEY!, "Content-Type": "application/json" },
  body: JSON.stringify({
    intent: "Swing-trade ETH and BTC perps only. Max $1,000 notional per order. Leverage at or below 5x. Never withdraw.",
    venue: "orderly",
    action,
  }),
});
const result = await res.json();
if (result.verdict !== "ALLOW") throw new Error(result.reasoning ?? result.error);
// Only now sign the request with your Orderly key and POST it to /v1/order.

The classifier’s line is Orderly ORDER: BUY 0.5 ETH on PERP_ETH_USDC @ 1700 (LIMIT) ≈ $850 notional, followed by the symbol’s status, mark price and maximum leverage when the lookup succeeds.

From an MCP client

Instruct the agent to call verify_intent before signing any Orderly request, with your rules as intent, the exact request body as action and venue: "orderly", and to act only on ALLOW.

Integrate

Chance verification

Payload adapters

HTTP endpoints

Orderly Network

What to send

Live lookup

Notes the classifier adds

Example

From an MCP client

​What to send

​Live lookup

​Notes the classifier adds

​Example

​From an MCP client

What to send

Live lookup

Notes the classifier adds

Example

From an MCP client