Orders

GET Order

get

Retrieve an order by its order ID.

Authorizations
Path parameters
orderIdstringRequired
Responses
200
Successful response
application/json
get
GET /api/v1/orders/{orderId} HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "orderStatus": "PLACED",
  "side": "BUY",
  "pair": "BTC-USD",
  "strategy": "RFQ",
  "limitPrice": "52100.00",
  "orderPrice": "52100.00",
  "leavesQty": "1.00",
  "orderQuantity": "1.00",
  "fillQuantity": "1.00",
  "cumulativeQty": "1.00",
  "fillPrice": "52100.00",
  "avgPrice": "52100.00",
  "orderType": "MARKET",
  "timeInForce": "DAY",
  "expireTime": "2025-05-31T23:59:59.000Z",
  "clientOrderId": "5f80d325-0f71-4f0a-a346-75c7bb6ac867",
  "fillPercentage": "100",
  "clientFeeRate": "10",
  "providerFeeRate": "10",
  "placedAt": "2025-07-05T19:49:39.168Z",
  "completedAt": null,
  "clientReference": "text",
  "rejectedAt": "2025-07-05T19:49:39.168Z",
  "orderRejectReason": "text",
  "currency": "BTC"
}

GET Orders

get

Retrieve a list of orders with optional filtering and pagination.

Authorizations
Query parameters
clientReferencestringOptional

Filter orders by client provided reference parameter

orderStatusstring · enumOptional

Filter orders by order status

Possible values:
placedAtStartstring · date-timeOptional

Filter orders by when the order was placed. Lower bound, exclusive

placedAtEndstring · date-timeOptional

Filter orders by when the order was placed. Upper bound, inclusive

completedAtStartstring · date-timeOptional

Filter orders by when the order was completely filled. Lower bound, exclusive

completedAtEndstring · date-timeOptional

Filter orders by when the order was completely filled. Upper bound, inclusive

accountIdstring · uuidOptional

Filter orders by account ID

pairstringOptional

Filter orders by pair

Example: BTC-USD
sidestringOptional

Filter orders by side

Example: BUY
afterstringOptional

When provided, specifies the last item returned in previous page, used to fetch the next page. Fetches the first page when omitted.

limitstring · integerOptional

When provided, specifies the number of items to return in the page. Uses default page size of 10 when omitted.

sortFieldstring · enumOptional

Will sort the returned data using the specified field.

Possible values:
sortDirectionstring · enumOptional

Specifies the sort direction for the sortField.

Possible values:
Responses
200
Successful response
application/json
get
GET /api/v1/orders HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "after": "text",
  "totalCount": "1",
  "items": [
    {
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "orderStatus": "PLACED",
      "side": "BUY",
      "pair": "BTC-USD",
      "strategy": "RFQ",
      "limitPrice": "52100.00",
      "orderPrice": "52100.00",
      "leavesQty": "1.00",
      "orderQuantity": "1.00",
      "fillQuantity": "1.00",
      "cumulativeQty": "1.00",
      "fillPrice": "52100.00",
      "avgPrice": "52100.00",
      "orderType": "MARKET",
      "timeInForce": "DAY",
      "expireTime": "2025-05-31T23:59:59.000Z",
      "clientOrderId": "5f80d325-0f71-4f0a-a346-75c7bb6ac867",
      "fillPercentage": "100",
      "clientFeeRate": "10",
      "providerFeeRate": "10",
      "placedAt": "2025-07-05T19:49:39.168Z",
      "completedAt": null,
      "clientReference": "text",
      "rejectedAt": "2025-07-05T19:49:39.168Z",
      "orderRejectReason": "text",
      "currency": "BTC"
    }
  ]
}

Execute a Quote (RFQ)

post

Execute a previously requested quote. Creates an Order and Executes it. Retuns both the order and the execution.

Authorizations
Body
quoteIdstring · uuidRequired

The quoteId returned by Request Quote

clientReferencestringOptional
Responses
200
Successful response
application/json
post
POST /api/v1/orders HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "clientReference": "text"
}
{
  "order": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "orderStatus": "PLACED",
    "side": "BUY",
    "pair": "BTC-USD",
    "strategy": "RFQ",
    "orderPrice": "52100.00",
    "orderQuantity": "1.00",
    "fillQuantity": "1.00",
    "fillPrice": "52100.00",
    "fillPercentage": "100",
    "clientFeeRate": "10",
    "providerFeeRate": "10",
    "placedAt": "2025-07-05T19:49:39.168Z",
    "completedAt": null,
    "clientReference": "text"
  },
  "executions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "executedAt": "2025-07-05T19:49:39.168Z",
      "pair": "BTC-USD",
      "side": "BUY",
      "deliverCurrency": "BTC",
      "deliverQuantity": "1.00",
      "receiveCurrency": "USD",
      "receiveQuantity": "52100.00",
      "price": "52100.00",
      "baseQuantity": "0.0016",
      "quoteQuantity": "10.74",
      "clientFeeRate": "10",
      "providerFeeRate": "10",
      "clientFeeQuantity": "52.10",
      "providerFeeQuantity": "52.10",
      "feeCurrency": "USD",
      "executionStatus": "TRADE_EXECUTED",
      "tradeDate": "2025-07-05",
      "valueDate": "2025-07-05",
      "confirmedAt": "2025-07-05T19:49:39.168Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Create Order

post

For orders to be accepted, the account must have sufficient buying power. Once placed, an amount equivalent to the maximum potential value of the order will be reserved from the account balance for the duration that the order remains open.

Authorizations
Body
one ofOptional
or
or
Responses
200
Successful response
application/json
Responseone of
or
post
POST /api/v1/orders HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "orderType": "PREVIOUSLY_QUOTED",
  "clientReference": "text"
}
{
  "order": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "orderStatus": "PLACED",
    "side": "BUY",
    "pair": "BTC-USD",
    "strategy": "RFQ",
    "orderPrice": "52100.00",
    "orderQuantity": "1.00",
    "fillQuantity": "1.00",
    "fillPrice": "52100.00",
    "fillPercentage": "100",
    "clientFeeRate": "10",
    "providerFeeRate": "10",
    "placedAt": "2025-07-05T19:49:39.168Z",
    "completedAt": null,
    "clientReference": "text"
  },
  "executions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "executedAt": "2025-07-05T19:49:39.168Z",
      "pair": "BTC-USD",
      "side": "BUY",
      "deliverCurrency": "BTC",
      "deliverQuantity": "1.00",
      "receiveCurrency": "USD",
      "receiveQuantity": "52100.00",
      "price": "52100.00",
      "baseQuantity": "0.0016",
      "quoteQuantity": "10.74",
      "clientFeeRate": "10",
      "providerFeeRate": "10",
      "clientFeeQuantity": "52.10",
      "providerFeeQuantity": "52.10",
      "feeCurrency": "USD",
      "executionStatus": "TRADE_EXECUTED",
      "tradeDate": "2025-07-05",
      "valueDate": "2025-07-05",
      "confirmedAt": "2025-07-05T19:49:39.168Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Cancel an Order (WIP)

delete

Cancel a LIMIT order in NEW status

Authorizations
Path parameters
orderIdstringRequired
Responses
200
OK
application/json
delete
DELETE /api/v1/orders/{orderId} HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "orderId": "876818f4-e054-49ec-a2de-313f9fc96b92",
  "orderStatus": "PLACED"
}

Last updated