Place an order

Place an order

Description: Place an order on the trading bridge

group=tradeApi 
version=0.0.1 
bizType=tradeapi.admin.OrderAdminApiService.addDirectOrder 

Special instructions for binance exchange:

1. The minimum order requirement is 5 USDT
2. Trading rules for placing orders: https://www.binance.com/zh-CN/trade-rule
3. Limit orders only support volume-based orders.

OKX Exchange Special Instructions

1. The timeInForce input parameter of the order interface is invalid.
2. The order interface only returns the clientOrderId and status fields.
3. Limit orders only support volume-based orders.

POST/global/tradeapi.admin.OrderAdminApiService.addDirectOrder

Header parameters

Body

application/json

tradeType*integer (long)

Game type. 10-Transaction Bridge;

customerIdinteger (long)

CustomerId

customerNo*string

Customer code

customerGroupId*integer (long)

Customer group ID: 1=default customer group;

exchangeId*string

Platform identifier. binance-Binance; okx-OUYi

accountName*string

Platform account alias

symbolId*integer (long)

ProductId

bizType*integer (int32)

Business type. 1-market price; 2-limit price

direction*integer (int32)

Order buying and selling direction, 1-buy; 2-sell;

pricestring

Required for limit orders. Limit price, this field is invalid for market orders

numstring

Order quantity. Fill in at least one with amount. All fields shall be filled in with num.

amountstring

The total amount of the order. Fill in at least one with num. All fields shall be filled in with num.

timeInForcestring

Order Validity Method. GTC - until all transactions are completed or canceled; IOC - as many transactions as possible immediately, and partial cancellations that cannot be completed; FOK - all transactions or all cancellations; (This field is invalid for market orders, and the limit price defaults to GTC)

clientOrderIdstring

Customer-defined unique order ID. If left blank, it will be automatically generated. (Need to meet this regular expression rule: ^[a-zA-Z0-9]{1,20}$)

requestTimeinteger (long)

Request time. 13-digit timestamp. If not filled in, the default is the time when the system receives the order.

Response

200

Body

application/json

bizCodestring

Module identification code

codestring

status return code

msgstring

Status description

tminteger (int64)

Processing time (milliseconds)

tracestring

tracking code

msgParamsstring

Returns the placeholder parameter string in the description. Multiple parameters are separated by,

okboolean

Is the response successful?

failboolean

Whether the response failed

dataobject

data body

Request

JavaScriptCurlPython

const response = await fetch('/global/tradeapi.admin.OrderAdminApiService.addDirectOrder', {
    method: 'POST',
    headers: {
      "companyId": "text",
      "trace": "text",
      "apiKey": "text",
      "signature": "text",
      "version": "text",
      "group": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "exchangeId": "text",
      "customerNo": "text",
      "accountName": "text"
    }),
});
const data = await response.json();

Response

200

{
  "bizCode": "text",
  "code": "text",
  "msg": "text",
  "trace": "text",
  "msgParams": "text",
  "ok": false,
  "fail": false,
  "data": {
    "exchangeId": "text",
    "orderId": "text",
    "clientOrderId": "text",
    "status": "text",
    "timeInForce": "text",
    "executeNum": "text",
    "executeAmount": "text",
    "executeList": [
      {
        "executeNum": "text",
        "executePrice": "text",
        "commission": "text",
        "commissionCurrency": "text",
        "tradeId": "text"
      }
    ]
  }
}