Place an order

Place an order

post

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.

Header parameters

companyIdstringRequired

Company ID

Example: {{company}}

tracestringRequired

Global link unique identifier

Example: {{mock_trace}}

apiKeystringRequired

apiKey

Example: {{apikey}}

recvWindowstringOptional

time window

Example: 5000

signaturestringRequired

sign

Example: {{sign}}

langstringOptional

language

Example: zh-CN

versionstringRequired

Interface version

Example: 0.0.1

groupstringRequiredExample: tradeApi

Body

tradeTypeinteger · longRequired

Game type. 10-Transaction Bridge;

customerIdinteger · longOptional

CustomerId

customerNostringRequired

Customer code

customerGroupIdinteger · longRequired

Customer group ID: 1=default customer group;

exchangeIdstringRequired

Platform identifier. binance-Binance; okx-OUYi

accountNamestringRequired

Platform account alias

symbolIdinteger · longRequired

ProductId

bizTypeinteger · int32Required

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

directioninteger · int32Required

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

pricestringOptional

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

numstringOptional

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

amountstringOptional

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

timeInForcestringOptional

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)

clientOrderIdstringOptional

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 · longOptional

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

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /global/tradeapi.admin.OrderAdminApiService.addDirectOrder HTTP/1.1
Host: 
companyId: text
trace: text
apiKey: text
signature: text
version: text
group: text
Content-Type: application/json
Accept: */*
Content-Length: 254

{
  "tradeType": 1,
  "customerId": 1,
  "customerNo": "text",
  "customerGroupId": 1,
  "exchangeId": "text",
  "accountName": "text",
  "symbolId": 1,
  "bizType": 1,
  "direction": 1,
  "price": "text",
  "num": "text",
  "amount": "text",
  "timeInForce": "text",
  "clientOrderId": "text",
  "requestTime": 1
}

200Success

{
  "bizCode": "text",
  "code": "text",
  "msg": "text",
  "tm": 1,
  "trace": "text",
  "msgParams": "text",
  "ok": true,
  "fail": true,
  "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"
      }
    ]
  }
}