RFQ

Request Quote (RFQ)

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

post

/v1/quotes

Authorizations

Body

one of

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cams.aquanow.com/api/v1/quotes' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "pair": "BTC-USD",
    "side": "BUY",
    "deliverQuantity": "103.06",
    "clientFeeRate": "30",
    "clientReference": "text"
  }'

200

400

401

403

4XX

5XX

200

{
  "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": "103.06",
  "deliverCurrency": "USD",
  "receiveQuantity": "0.0016",
  "receiveCurrency": "BTC",
  "price": "64237.47",
  "baseQuantity": "0.0016",
  "quoteQuantity": "10.74",
  "feeCurrency": "USD",
  "clientFeeRate": "30",
  "clientFeeQuantity": "0.10",
  "providerFeeRate": "30",
  "providerFeeQuantity": "0.08",
  "quoteStatus": "AWAITING_RESPONSE",
  "clientReference": "text",
  "tradeTaxRate": "5",
  "clientTaxQuantity": "0.54",
  "providerTaxQuantity": "0.43"
}

Successful response

Cancel Quote (RFQ)

Cancel a previously requested quote.

delete

/v1/quotes/{quoteId}

Authorizations

Path parameters

quoteIdstring · uuidrequired

The quoteId returned by the Request Quote

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cams.aquanow.com/api/v1/quotes/{quoteId}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

400

401

403

4XX

5XX

200

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

OK

Execute a Quote (RFQ)

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

post

/v1/orders

Authorizations

Body

quoteIdstring · uuidrequired

The quoteId returned by Request Quote

clientReferencestring

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cams.aquanow.com/api/v1/orders' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "quoteId": "123e4567-e89b-12d3-a456-426614174000",
    "clientReference": "text"
  }'

200

400

401

403

4XX

5XX

200

{
  "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-03-09T13:41:42.975Z",
    "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-03-09T13:41:42.975Z",
      "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-03-09",
      "valueDate": "2025-03-09",
      "confirmedAt": "2025-03-09T13:41:42.975Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Successful response