Skip to main content
The app calls the order endpoint with an equity mint as inputMint or outputMint. The response is a direct fill or an escrow fill.

​
Equity Request Parameters

​
Direct Fill or Escrow Fill

The counterparty with the best price decides how a buy settles: a direct fill if it has inventory, otherwise an escrow fill. executionMode says which: sync for a direct fill, async for an escrow fill. A sell is always a direct fill. allowAsyncExec=false returns only direct fills. allowSyncExec=false returns only escrow fills, so a sell with it returns 400 with code route_not_found. If a request cannot be settled either way, the order endpoint routes it as for any other token, and the response has no equity fields.

​
Equity Response Fields

The response is an OrderResponse. A direct fill or escrow fill response adds these fields: submitEndpointRequired is present, and true, only when the response goes to the submit transaction endpoint. The scaled fields are present only when the equity mint carries the Token-2022 Scaled UI Amount extension, which stores a multiplier on the mint while token accounts hold the raw amount. A sell adds inAmountScaledUi, and a buy adds outAmountScaledUi and minOutAmountScaledUi. Each scales the matching amount and truncates it: outAmountScaledUi = floor(outAmount × scaledUiMultiplier) / 10^decimals For a mint with 9 decimals and a scaledUiMultiplier of 1.2:
  • outAmount is "2500000000".
  • outAmountScaledUi is "3" (2500000000 × 1.2 / 10^9), so the app shows 3, not 2.5.
Equity mints can be Token-2022 mints, so the app reads the mint account’s owner to choose the token program instead of hard-coding it.