Get Fills

GET /api/v1/crypto/accounts/{acc_id}/fills

Query fill details by order ID. Supports querying multiple orders simultaneously, up to 20.

Path Parameters

Parameter	Type	Required	Description
acc_id	uint64	Yes	Account ID

Request Parameters

Parameter	Type	Location	Required	Description
order_id	string	Query	Yes	Order ID. Multiple order IDs can be comma-separated, up to 20.
page_size	uint32	Query	No	Number of results per page. Maximum 50, default 50.
page_flag	string	Query	No	Pagination cursor. Omit on first request.

Response Parameters

Field	Type	Description
order_fills	list[FillItem]	Fill list
page_flag	string	Pagination cursor for the next request
completed	bool	true indicates all data has been returned; the client should stop paginating

Request Example

curl -X GET "https://webapi.futunn.com/api/v1/crypto/accounts/123456/fills?order_id=FTHC2989880641155745280T&page_size=10" \
  -H "X-Api-Key: <AppKey>" \
  -H "X-Timestamp: <timestamp_ms>" \
  -H "X-Nonce: <nonce>" \
  -H "Authorization: <signature_base64>"

Response Example

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_fills": [
      {
        "order_id": "FTHC2989880641155745280T",
        "fill_id": "FILL-001",
        "symbol_pair": { "symbol": "BTCUSD", "base": "BTC", "quote": "USD" },
        "side": "BUY",
        "quantity": "0.01",
        "price": "30000",
        "amount": "300.00",
        "fill_time": 1750000050000000
      }
    ],
    "page_flag": "",
    "completed": true
  }
}

Error Response:

{
  "code": 1,
  "msg": "Error Message."
}