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

companyIdstringrequired

Company ID

Example: {{company}}

tracestringrequired

Global link unique identifier

Example: {{mock_trace}}

apiKeystringrequired

apiKey

Example: {{apikey}}

recvWindowstring

time window

Example: 5000

signaturestringrequired

sign

Example: {{sign}}

langstring

language

Example: zh-CN

versionstringrequired

Interface version

Example: 0.0.1

groupstringrequired

Example: tradeApi

Body

tradeTypeinteger · longrequired

Game type. 10-Transaction Bridge;

customerIdinteger · long

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;

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.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/global/tradeapi.admin.OrderAdminApiService.addDirectOrder' \
  --header 'companyId: text' \
  --header 'trace: text' \
  --header 'apiKey: text' \
  --header 'signature: text' \
  --header 'version: text' \
  --header 'group: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "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
  }'

200

200

{
  "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"
      }
    ]
  }
}