Skip to navigation

Place recurring buy order

Create a recurring buy (dollar-cost averaging) strategy that periodically invests a fixed amount across a basket of currencies.

Authentication

OK-ACCESS-KEYstring
Your API key.
OK-ACCESS-SIGNstring

Base64-encoded HMAC-SHA256 signature of the prehash string.

OK-ACCESS-TIMESTAMPstring

ISO 8601 UTC timestamp, e.g. 2020-12-08T09:08:57.715Z.

OK-ACCESS-PASSPHRASEstring
The passphrase you set when creating the API key.

Request

This endpoint expects an object.
stgyNamestringRequired
Custom name for trading bot, no more than 40 characters
recurringListlist of objectsRequired
Recurring buy info
periodenumRequired

Period monthly weekly daily hourly

Allowed values:
recurringTimestringRequired

Recurring buy time, the value range is an integer of [0,23] When the period is hourly, the parameter is the time of the first investment occurs.

timeZonestringRequired

UTC time zone, the value range is an integer of [-12,14] e.g. "8" representing UTC+8 (East 8 District), Beijing Time

amtstringRequired
Quantity invested per cycle
investmentCcyenumRequired

The invested quantity unit, can only be USDT/USDC

Allowed values:
tdModeenumRequired

Trading mode Margin mode: cross Non-Margin mode: cash

Allowed values:
recurringDaystringOptional

Recurring buy date When the period is monthly, the value range is an integer of [1,28] When the period is weekly, the value range is an integer of [1,7] When the period is daily/hourly, the parameter is not required.

recurringHourenumOptional

Recurring buy by hourly 1/4/8/12, e.g. 4 represents "recurring buy every 4 hour" When the period is hourly, the parameter is required.

Allowed values:
algoClOrdIdstringOptional

Client-supplied Algo ID There will be a value when algo order attaching algoClOrdId is triggered, or it will be "". A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 32 characters.

tagstringOptional

Order tag A combination of case-sensitive alphanumerics, all numbers, or all letters of up to 16 characters.

tradeQuoteCcystringOptional
The quote currency for trading.

Response

Successful response
codestringOptional

Result code. 0 means success; any other value is an error code.

msgstringOptional
Error message. Empty on success.
datalist of objectsOptional