Create batch of orders

POST

1 import requests
2 headers = {
3   'Content-Type':'application-json',
4   'Accept': 'application/json',
5   'Authorization': 'Bearer {JWT}'
6 }
7 
8 r = requests.post('https://api.prod.paradex.trade/v1/orders/batch', headers = headers)
9 
10 print(r.json())

Play

201Created

1 {
2   "errors": [
3     {
4       "error": "VALIDATION_ERROR",
5       "message": "message"
6     }
7   ],
8   "orders": [
9     {
10       "account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512x",
11       "avg_fill_price": "26000",
12       "cancel_reason": "NOT_ENOUGH_MARGIN",
13       "client_id": "x1234",
14       "created_at": 1681493746016,
15       "flags": [
16         "REDUCE_ONLY"
17       ],
18       "id": "123456",
19       "instruction": "GTC",
20       "last_updated_at": 1681493746016,
21       "market": "BTC-USD-PERP",
22       "price": "26000",
23       "published_at": 1681493746016,
24       "received_at": 1681493746016,
25       "remaining_size": "0",
26       "seq_no": 1681471234972000000,
27       "side": "BUY",
28       "size": "0.05",
29       "status": "NEW",
30       "stp": "EXPIRE_MAKER",
31       "timestamp": 1681493746016,
32       "trigger_price": "26000",
33       "type": "MARKET"
34     }
35   ]
36 }

[Experimental] 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.

Request

This endpoint expects a list of objects.

instructionstringRequired

Order Instruction, GTC, IOC or POST_ONLY if empty GTC

marketstringRequired

Market for which order is created

pricestringRequired

Order price

sideenumRequired

Order side

Allowed values:

signaturestringRequired

Order Payload signed with STARK Private Key

signature_timestampintegerRequired

Timestamp of order creation, used for signature verification

sizestringRequired

Size of the order

typeenumRequired

Order type

client_idstringOptional<=64 characters

Unique client assigned ID for the order

flagslist of enumsOptional

Order flags, allow flag: REDUCE_ONLY

Allowed values:

recv_windowintegerOptional

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

stpstringOptional

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

trigger_pricestringOptional

Trigger price for stop order

Response

Created

errorslist of objectsOptional

orderslist of objectsOptional

Create batch of orders

Headers

Request

Response

Errors