Orders

Create batch of orders

Changed on

Place a batch of orders

  • Valid batch size is between 1-10 order(s)
  • If basic validation(including signature) fails - all orders will be rejected.
  • Orders are queued for risk checking independently and failure of one order doesn't affect processing of another order.
post/orders/batch

Request

  • Base URL
    https://api.prod.paradex.trade/v1
  • URL
    https://api.prod.paradex.trade/v1/orders/batch
  • Auth
    API key in header Authorization

Request body

client_idstring

Unique client assigned ID for the order

dime_discountboolean

If true, fees are charged in DIME with the DIME discount applied; falls back to USDC if balance is insufficient

flagsResponsesOrderFlag[]

Order flags: REDUCE_ONLY, MMP. MMP is for LIMIT orders on dated options and perpetual futures; only resting maker fills count

instruction'GTC' | 'POST_ONLY' | 'IOC' | 'RPI' required
marketstring required

Market for which order is created

on_behalf_of_accountstring

ID corresponding to the configured isolated margin account. Only for isolated margin orders

pricestring required

Order price

recv_windowinteger

Order will be created if it is received by API within RecvWindow milliseconds from signature timestamp, minimum is 10 milliseconds

side'BUY' | 'SELL' required
signaturestring required

Order signature in as a string "[r,s]" signed by account's paradex private key

signature_timestampinteger required

Unix timestamp in milliseconds of order creation, used for signature verification

sizestring required

Size of the order

stpstring

Self Trade Prevention, EXPIRE_MAKER, EXPIRE_TAKER or EXPIRE_BOTH, if empty EXPIRE_TAKER

trigger_pricestring

Trigger price for stop order

type'MARKET' | 'LIMIT' | 'STOP_LIMIT' | 'STOP_MARKET' | 'TAKE_PROFIT_LIMIT' | 'TAKE_PROFIT_MARKET' | 'STOP_LOSS_MARKET' | 'STOP_LOSS_LIMIT' required
vwap_pricestring

Optional VWAP price for market orders used for VWAP instruction, bounded by price band

Example request

[
  {
    "client_id": "123454321",
    "market": "BTC-USD-PERP",
    "on_behalf_of_account": "0x1234567890abcdef",
    "price": "29500.12",
    "size": "1.213"
  }
]

Response

Created

Example response

{
  "orders": [
    {
      "account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512x",
      "avg_fill_price": "26000",
      "cancel_reason": "NOT_ENOUGH_MARGIN",
      "client_id": "x1234",
      "created_at": 1681493746016,
      "id": "123456",
      "last_updated_at": 1681493746016,
      "market": "BTC-USD-PERP",
      "price": "26000",
      "published_at": 1681493746016,
      "received_at": 1681493746016,
      "remaining_size": "0",
      "seq_no": 1681471234972000000,
      "size": "0.05",
      "timestamp": 1681493746016,
      "trigger_price": "26000"
    }
  ]
}

Changes

  • f33feb7333eaRevision changes
    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_NOT_PARADEX_ACCOUNT enum value to the // response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the //// response property for the response status

    • warning

      added the new ADDRESS_BOOK_REPEATED_IN_IMPORT enum value to the // response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the //// response property for the response status

    • warning

      added the new STARKNET_PARENT_ONBOARDING_DISABLED enum value to the // response property for the response status

  • 72c125c93c2bRevision changes
    • warning

      added the new SESSION_EXPIRED enum value to the //// response property for the response status

    • warning

      added the new SESSION_EXPIRED enum value to the // response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the //// response property for the response status

    • warning

      added the new SESSION_REVOKED enum value to the // response property for the response status