Skip to main content
POST
/
v1beta1
/
insert_order_cross
Insert Order Cross
curl --request POST \
  --url https://traderapi.us-east-1.privatelink.preprod.polymarketexchange.com/api/v1beta1/insert_order_cross \
  --header 'Content-Type: application/json' \
  --data '
{
  "block_trade_indicator": true,
  "cross_id": "<string>",
  "cross_prioritized_side": "SIDE_UNDEFINED",
  "cross_type": "CROSS_TYPE_UNDEFINED",
  "requests": [
    {
      "account": "trading-account-456",
      "all_or_none": true,
      "best_limit": true,
      "cash_order_qty": "<string>",
      "client_account_id": "<string>",
      "client_participant_id": "<string>",
      "clord_id": "<string>",
      "commission_override_basis_points": "<string>",
      "commission_override_flat_fee": "<string>",
      "good_till_time": "2023-11-07T05:31:56Z",
      "ignore_price_validity_checks": true,
      "immediately_executable_limit": true,
      "manual_order_indicator": "MANUAL_ORDER_INDICATOR_UNDEFINED",
      "min_qty": "<string>",
      "order_capacity": "ORDER_CAPACITY_UNDEFINED",
      "order_qty": "<string>",
      "participate_dont_initiate": true,
      "price": "5500",
      "quote": "<string>",
      "self_match_prevention_id": "<string>",
      "self_match_prevention_instruction": "SELF_MATCH_PREVENTION_INSTRUCTION_UNDEFINED",
      "session_id": "<string>",
      "side": "SIDE_UNDEFINED",
      "stop_price": "<string>",
      "strict_limit": true,
      "symbol": "aec-nfl-buf-nyj-2025-01-15",
      "symbol_sub_type": "<string>",
      "time_in_force": "TIME_IN_FORCE_UNDEFINED",
      "trigger_method": "CONDITION_TRIGGER_METHOD_UNDEFINED",
      "type": "ORDER_TYPE_UNDEFINED",
      "user": "<string>"
    }
  ],
  "transaction_booked_time": "2023-11-07T05:31:56Z"
}
'
{
  "responses": [
    {
      "order_id": "1ABC2DEF3GHI4"
    }
  ]
}

Body

application/json

Request to insert orders for a cross with the given details.

​
block_trade_indicator
boolean

A flag that if set indicates that this cross represents a block trade.

​
cross_id
string

Client assigned free-form ID for the cross (required).

​
cross_prioritized_side
enum<string>
default:SIDE_UNDEFINED

Side indicates the side of an Order.

Available options:
SIDE_UNDEFINED,
SIDE_BUY,
SIDE_SELL
​
cross_type
enum<string>
default:CROSS_TYPE_UNDEFINED

CrossType specifies the type of order cross. Must be set when inserting a cross.

  • CROSS_TYPE_ALL_OR_NONE: Cross order will either fill all of the order quantity or none of it
Available options:
CROSS_TYPE_UNDEFINED,
CROSS_TYPE_ALL_OR_NONE
​
requests
object[]

A list of orders to insert (Only supports 2 orders at a time).

​
transaction_booked_time
string<date-time>

The time at which the order was booked.

Response

A successful response.

​
responses
object[]

A list of responses to inserted orders.