Skip to content

Find orders#

GET https://api.pro.anboto.xyz/api/v2/trading/order/find

Only matched order within 3 days will be return ApiKeyAuth required.

Query params#

startMs integer
The start time for the query as ms since epoch
endMs integer
The end time for the query as ms since epoch
limit integer
The maximum number of orders to return in the results

Headers#

Header
X-API-KEY string required
X-TIMESTAMP int64 ms required
X-SIGN string required
X-RECV-WINDOW int, default 5000

Responses#
200 The list of matching orders.
401 Unauthorized, Invalid Signature
429 Rate limit exceeded, retry later

Response fields — OrderDetailsList#

orders array[OrderDetails] required
The list of order details for separate orders.
orders[].order_id integer
The Anboto generated order id
Example: 123456
orders[].client_order_id string
The client provided order id
Example: xxx-yyy-zzz
orders[].symbol string
The order symbol in Anboto's symbology
orders[].status enum
The order status — PENDING_NEW, ACCEPTED, REJECTED, PARTIALLY_FILLED, FILLED, PENDING_CANCEL, CANCELLED, PENDING_PAUSE, … (12 values)
orders[].asset_class enum
The Asset category of the order. — SPOT, FUTURE
Example: SPOT
orders[].exchange enum
The exchanges available for order placement via the API — BINANCE, HUOBI, GATEIO, KUCOIN, OKX, BYBIT, BITGET, WOO, … (15 values)
orders[].strategy enum
The execution strategy for the order. — TWAP, VWAP, ICEBERG, POV, MARKET, LIMIT, IS, SCALE
Example: VWAP
orders[].start_time number
The time when the order start trading from epoch time in ms
orders[].end_time number
The time when the order is finished from epoch time in ms
orders[].filled_quantity number required
The absolute amount of the order quantity filled
Example: 0
orders[].leaves_quantity number required
The absolute amount of the order quantity remaining to be filled
Example: 0
orders[].side enum
The side of the book to trade. — BUY, SELL
orders[].last_quantity number required
The last qty received in a fill from the exchange
Example: 0
orders[].last_price number required
The last price executed on the exchange
Example: 0
orders[].average_price number required
The average execution price of the order
Example: 0
orders[].trades array[TradeDetails]
The list of trades associated with this order when include_trades=true
orders[].trades[].trade_id integer
The trade id from exchange
Example: 123456
orders[].trades[].symbol string required
The order symbol using Anboto symbology
orders[].trades[].exchangeOrderId string
The order id from exchange
orders[].trades[].clientOrderId string
The client order id
orders[].trades[].quantity number required
The absolute amount of the order quantity filled
Example: 0
orders[].trades[].price number required
The traded price
Example: 0
orders[].trades[].direction string
The direction of the trade
orders[].trades[].makerOrTaker string
The trade is from Maker or Taker
orders[].trades[].execTime integer
The time where the trade executed
orders[].trades[].fee number
The fee charged on the trade
orders[].trades[].feeCurrency string
The asset type the fee was charged in
orders[].fees_infos object
Aggregated fees per currency when include_fees=true
curl -X GET "$BASE/api/v2/trading/order/find?startMs=0" \
  -H "X-API-KEY: $API_KEY" -H "X-TIMESTAMP: $ts" \
  -H "X-SIGN: $sign"

params = {"startMs": ..., "endMs": ..., "limit": ...}
r = requests.get(f"{BASE}/api/v2/trading/order/find",
    params=params
    headers=signed_headers_query(params))
print(r.json())

let resp = client
    .get(format!("{BASE}/api/v2/trading/order/find?startMs=0"))
    .headers(signed_headers_query(&params))
    .send()?;
println!("{}", resp.text()?);

req, _ := http.NewRequest("GET", BASE+"/api/v2/trading/order/find?startMs=0", nil)
for k, v := range signedHeadersQuery(req.URL.Query()) {
    req.Header.Set(k, v)
}
resp, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()
io.Copy(os.Stdout, resp.Body)

HttpResponse<String> resp = client.send(
    signedGet("/api/v2/trading/order/find?startMs=0"),
    HttpResponse.BodyHandlers.ofString());

const res = await fetch(`${BASE}/api/v2/trading/order/find?startMs=0`, {
  method: "GET",
  headers: signedHeadersQuery(params),
});
const data: OrderDetailsList = await res.json();

val request = signedGet("/api/v2/trading/order/find?startMs=0")
val response = client.send(request, HttpResponse.BodyHandlers.ofString())
println(response.body())

cpr::Response r = cpr::Get(
    cpr::Url{BASE + "/api/v2/trading/order/find?startMs=0"},
    signedHeadersQuery(params));
std::cout << r.text << std::endl;

const res = await fetch(`${BASE}/api/v2/trading/order/find?startMs=0`, {
  method: "GET",
  headers: signedHeadersQuery(params),
});
console.log(await res.json());

Response 200

{
  "orders": [
    {
      "order_id": 123456,
      "client_order_id": "xxx-yyy-zzz",
      "symbol": "string",
      "status": "PENDING_NEW",
      "asset_class": "SPOT",
      "exchange": "BINANCE",
      "strategy": "TWAP",
      "start_time": 0.0,
      "end_time": 0.0,
      "filled_quantity": 0,
      "leaves_quantity": 0,
      "side": "BUY",
      "last_quantity": 0,
      "last_price": 0,
      "average_price": 0,
      "trades": [
        {}
      ],
      "fees_infos": {}
    }
  ]
}