Create algo order | Paradex

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

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

Allowed values:

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

Allowed values:

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

Allowed values:

sizestring

Algo size

statusenum

Algo status

Allowed values:

Errors

400

Bad Request Error

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

API Key authentication via header

Algo type, required for algo orders creation

Duration in seconds for which the algo order will be running, required for algo orders creation

Market for which order is created

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

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

Size of the algo order

Algo order type, only MARKET is supported

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

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

Account identifier (user’s account address)

Average fill price of the order

Reason for algo cancellation if it was closed by cancel

Unique algo identifier

Algo last update time. No changes once status=CLOSED

Market to which algo belongs

Remaining size of the algo

$	curl -X POST https://api.testnet.paradex.trade/v1/algo/orders \
>	-H 'Content-Type: application/json' \
>	-H 'Accept: application/json' \
>	-H 'Authorization: Bearer {JWT}'

1	{
2	"account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512",
3	"algo_type": "TWAP",
4	"avg_fill_price": "26000",
5	"cancel_reason": "NOT_ENOUGH_MARGIN",
6	"created_at": 1681493746016,
7	"end_at": 1681493746016,
8	"id": "123456",
9	"last_updated_at": 1681493746016,
10	"market": "BTC-USD-PERP",
11	"remaining_size": "0",
12	"side": "BUY",
13	"size": "0.05",
14	"status": "NEW"
15	}

$	curl -X POST https://api.testnet.paradex.trade/v1/algo/orders \
>	-H 'Content-Type: application/json' \
>	-H 'Accept: application/json' \
>	-H 'Authorization: Bearer {JWT}'

1	{
2	"account": "0x4638e3041366aa71720be63e32e53e1223316c7f0d56f7aa617542ed1e7512",
3	"algo_type": "TWAP",
4	"avg_fill_price": "26000",
5	"cancel_reason": "NOT_ENOUGH_MARGIN",
6	"created_at": 1681493746016,
7	"end_at": 1681493746016,
8	"id": "123456",
9	"last_updated_at": 1681493746016,
10	"market": "BTC-USD-PERP",
11	"remaining_size": "0",
12	"side": "BUY",
13	"size": "0.05",
14	"status": "NEW"
15	}