RFQ

Request Quote (RFQ)

post

/v1/quotes

Request a quote for a currency conversion. Specify deliver quantity or receive quantity, but not both.

Authorizations

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

or

Responses

200

Successful response

application/json

400

Validation Error

401

Unauthorized

403

Insufficient Privileges

409

Duplicate request error

application/json

4XX

Client error

5XX

Server error

post/v1/quotes

POST /api/v1/quotes HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 176

{
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "pair": "BTC-USD",
  "side": "BUY",
  "deliverQuantity": "22",
  "clientFeeRate": "30",
  "clientFeeAmount": "5.50",
  "clientReference": "text"
}

{
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "requestedAt": "2024-08-01T18:44:05Z",
  "expiresAt": "2024-08-01T18:44:05Z",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "pair": "BTC-USD",
  "side": "BUY",
  "deliverQuantity": "22.02",
  "deliverCurrency": "USD",
  "receiveQuantity": "0.0016",
  "receiveCurrency": "BTC",
  "price": "64237.47",
  "baseQuantity": "0.0016",
  "quoteQuantity": "10.74",
  "feeCurrency": "USD",
  "clientFeeRate": "30",
  "clientFeeAmount": "5.50",
  "clientFeeQuantity": "0.10",
  "providerFeeRate": "30",
  "providerFeeQuantity": "0.08",
  "quoteStatus": "AWAITING_RESPONSE",
  "clientReference": "text",
  "tradeTaxRate": "5",
  "clientTaxQuantity": "0.54",
  "providerTaxQuantity": "0.43"
}

Cancel Quote (RFQ)

delete

/v1/quotes/{quoteId}

Cancel a previously requested quote.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

quoteIdstring · uuidRequired

The quoteId returned by the Request Quote

Responses

200

OK

application/json

quoteIdstring · uuidOptional

quoteStatusstringOptionalExample: CANCELED

canceledAtstring · date-timeOptional

Date-time in ISO 8601 format

Example: 2024-08-01T18:44:05Z

400

Validation Error

401

Unauthorized

403

Insufficient Privileges

4XX

Client error

5XX

Server error

delete/v1/quotes/{quoteId}

DELETE /api/v1/quotes/{quoteId} HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "quoteStatus": "CANCELED",
  "canceledAt": "2024-08-01T18:44:05Z"
}

Execute a Quote (RFQ)

post

/v1/orders

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

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

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-01-01T00:00:00.000Z",
    "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-01-01T00:00:00.000Z",
      "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-01-01",
      "valueDate": "2026-01-01",
      "confirmedAt": "2026-01-01T00:00:00.000Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}