Testnet API ReferenceAlgos

Create algo order

Create a new algo order ### TWAP TWAP orders break a large trade into smaller ones over time to reduce market impact: - Sub-orders are placed every 30 seconds. - Order duration is between 30 and 86,400 seconds, in multiples of 30. - Supported sub order type: MARKET

Authentication

Authorizationstring
API Key authentication via header

Request

Algo order content
algo_typestringRequired
Algo type, required for algo orders creation
duration_secondsintegerRequired
Duration in seconds for which the algo order will be running, required for algo orders creation
marketstringRequired
Market for which order is created
sideenumRequired
Algo order side
signaturestringRequired

Order signature in as a string “[r,s]” signed by account’s paradex private key

signature_timestampintegerRequired
Unix timestamp in milliseconds of order creation, used for signature verification
sizestringRequired
Size of the algo order
typeenumRequired
Algo order type, only MARKET is supported
on_behalf_of_accountstringOptional
ID corresponding to the configured isolated margin account. Only for isolated margin orders
recv_windowintegerOptional
Order will be created if it is received by API within RecvWindow milliseconds from signature timestamp, minimum is 10 milliseconds

Response

Created
accountstring

Account identifier (user’s account address)

algo_typeenum
Algo type
avg_fill_pricestring
Average fill price of the order
cancel_reasonstring
Reason for algo cancellation if it was closed by cancel
created_atinteger
Algo creation time
end_atinteger
Algo end time
idstring
Unique algo identifier
last_updated_atinteger

Algo last update time. No changes once status=CLOSED

marketstring
Market to which algo belongs
remaining_sizestring
Remaining size of the algo
sideenum
Algo side
sizestring
Algo size
statusenum
Algo status

Errors

400
Bad Request Error