Orders

GET Orders

get

https://cams.aquanow.com/apihttp://localhost:3001/apihttps://cams.dev.aquanow.com/apihttps://cams.staging.aquanow.com/apihttps://cams.cert.aquanow.com/apihttps://marketdata.aquanow.comhttps://marketdata.staging.aquanow.comhttps://marketdata.dev.aquanow.com

/v1/orders

Retrieve a list of orders with optional filtering and pagination.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

clientReferencestringOptional

Filter orders by client provided reference parameter

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

afterstring · nullableOptional

The token of the last item in the response

totalCountstring · integerOptional

The total number of items in the entire filtered data set

Example: 1

400

Validation Error

401

Unauthorized

403

Insufficient Privileges

4XX

Client error

5XX

Server error

get

/v1/orders

HTTPcURLJavaScriptPython

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",
      "clientFeeAmount": "5.50",
      "providerFeeRate": "10",
      "placedAt": "2026-03-10T17:28:33.500Z",
      "completedAt": null,
      "clientReference": "text",
      "rejectedAt": "2026-03-10T17:28:33.500Z",
      "orderRejectReason": "text",
      "currency": "BTC"
    }
  ]
}

GET Order

get

https://cams.aquanow.com/apihttp://localhost:3001/apihttps://cams.dev.aquanow.com/apihttps://cams.staging.aquanow.com/apihttps://cams.cert.aquanow.com/apihttps://marketdata.aquanow.comhttps://marketdata.staging.aquanow.comhttps://marketdata.dev.aquanow.com

/v1/orders/{orderId}

Retrieve an order by its order ID.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

orderIdstringRequired

Responses

200

Successful response

application/json

orderIdstring · uuidOptional

accountIdstring · uuidOptional

orderStatusstring · enumOptionalPossible values:

sidestringOptionalExample: BUY

pairstringOptionalExample: BTC-USD

strategystring · enumOptionalPossible values:

limitPricestring · number · nullableOptionalExample: 52100.00

orderPricestring · numberOptionalExample: 52100.00

leavesQtystring · numberOptional

Remaining quantity to be filled

Example: 1.00

orderQuantitystring · numberOptionalExample: 1.00

fillQuantitystring · numberOptionalExample: 1.00

cumulativeQtystring · numberOptional

Only exists for MARKET/LIMIT orders

Example: 1.00

fillPricestring · numberOptionalExample: 52100.00

avgPricestring · number · nullableOptional

Only exists for MARKET/LIMIT orders

Example: 52100.00

orderTypestring · enumOptionalPossible values:

timeInForceall of · nullableOptional

string · enumOptional

Time in force should be DAY for market orders

Example: DAYPossible values:

expireTimestring · date-time · nullableOptional

Only exists for LIMIT orders

Example: 2025-05-31T23:59:59.000Z

clientOrderIdstring · uuid · nullableOptionalExample: 5f80d325-0f71-4f0a-a346-75c7bb6ac867

fillPercentagestring · numberOptionalExample: 100

clientFeeRatestring · integer · nullableOptionalExample: 10

clientFeeAmountstring · number · nullableOptional

Fixed fiat fee amount in tenant native currency

Example: 5.50

providerFeeRatestring · integerOptionalExample: 10

placedAtstring · date-timeOptional

completedAtstring · date-time · nullableOptional

clientReferencestring · nullableOptional

rejectedAtstring · date-time · nullableOptional

Only exists for REJECTED orders

orderRejectReasonstring · nullableOptional

Only exists for REJECTED orders

currencystringOptionalExample: BTC

400

Validation Error

401

Unauthorized

403

Insufficient Privileges

4XX

Client error

5XX

Server error

get

/v1/orders/{orderId}

HTTPcURLJavaScriptPython

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",
  "clientFeeAmount": "5.50",
  "providerFeeRate": "10",
  "placedAt": "2026-03-10T17:28:33.500Z",
  "completedAt": null,
  "clientReference": "text",
  "rejectedAt": "2026-03-10T17:28:33.500Z",
  "orderRejectReason": "text",
  "currency": "BTC"
}

Create Order

post

https://cams.aquanow.com/apihttp://localhost:3001/apihttps://cams.dev.aquanow.com/apihttps://cams.staging.aquanow.com/apihttps://cams.cert.aquanow.com/apihttps://marketdata.aquanow.comhttps://marketdata.staging.aquanow.comhttps://marketdata.dev.aquanow.com

/v1/orders

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

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

X-Request-IdstringOptional

A client-supplied unique identifier for this request, used for safely retrying and deduplicating operations. When the same X-Request-Id is sent with multiple identical requests within a defined time window, the server treats them as the same logical operation and will not perform the side effect more than once. Instead, it will return the original result associated with that identifier, if available. The client should generate a collision-resistant value (for example, a UUID) and reuse it only when retrying the same operation.

Body

application/json

or

or

Responses

200

Successful response

application/json

Responseone of

or

400

Validation Error

401

Unauthorized

403

Insufficient Privileges

409

Duplicate request error

application/json

4XX

Client error

5XX

Server error

post

/v1/orders

HTTPcURLJavaScriptPython

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",
    "clientFeeAmount": "5.50",
    "providerFeeRate": "10",
    "placedAt": "2026-03-10T17:28:33.500Z",
    "completedAt": null,
    "clientReference": "text"
  },
  "executions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "executedAt": "2026-03-10T17:28:33.500Z",
      "pair": "BTC-USD",
      "side": "BUY",
      "orderType": "MARKET",
      "deliverCurrency": "BTC",
      "deliverQuantity": "1.00",
      "receiveCurrency": "USD",
      "receiveQuantity": "52100.00",
      "price": "52100.00",
      "baseQuantity": "0.0016",
      "quoteQuantity": "10.74",
      "clientFeeRate": "10",
      "clientFeeAmount": "5.50",
      "providerFeeRate": "10",
      "clientFeeQuantity": "52.10",
      "providerFeeQuantity": "52.10",
      "feeCurrency": "USD",
      "executionStatus": "TRADE_EXECUTED",
      "tradeDate": "2026-03-10",
      "valueDate": "2026-03-10",
      "confirmedAt": "2026-03-10T17:28:33.500Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Execute a Quote (RFQ)

post

https://cams.aquanow.com/apihttp://localhost:3001/apihttps://camsapi-dev.aquanow.com/apihttps://camsapi-staging.aquanow.com/apihttps://cams.cert.aquanow.com/api

/v1/orders

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

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

quoteIdstring · uuidRequired

The quoteId returned by Request Quote

clientReferencestringOptional

Responses

200

Successful response

application/json

400

Validation Error

401

Unauthorized

403

Insufficient Privileges

4XX

Client error

5XX

Server error

post

/v1/orders

HTTPcURLJavaScriptPython

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": "2026-03-10T17:28:33.500Z",
    "completedAt": null,
    "clientReference": "text"
  },
  "executions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "executedAt": "2026-03-10T17:28:33.500Z",
      "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": "2026-03-10",
      "valueDate": "2026-03-10",
      "confirmedAt": "2026-03-10T17:28:33.500Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Cancel an Order (WIP)

delete

https://cams.aquanow.com/apihttp://localhost:3001/apihttps://camsapi-dev.aquanow.com/apihttps://camsapi-staging.aquanow.com/apihttps://cams.cert.aquanow.com/api

/v1/orders/{orderId}

Cancel a LIMIT order in NEW status

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

orderIdstringRequired

Responses

200

OK

application/json

orderIdstringRequiredExample: 876818f4-e054-49ec-a2de-313f9fc96b92

orderStatusstring · enumRequiredPossible values:

401

Unauthorized

403

Insufficient Privileges

404

Not Found

application/json

4XX

Client error

5XX

Server error

delete

/v1/orders/{orderId}

HTTPcURLJavaScriptPython

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