Trading Strategies

Please contact [e-mail] to enable additional strategies.

RFQ

RFQ orders allow users to make a request for a quote, then decide if they wish to execute that quote.

Get an RFQ quote

GET https://api.aquanow.io/trades/v1/getQuote

getQuote endpoint allows users to get an RFQ quote from Aquanow, and receive quoteId and price that is valid during the lifetime of the RFQ.

This endpoint is not executable and can only be used as a means of pricing your order.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Query Parameters

Headers

200: OK Get RFQ quote for buying BTC worth $1000 USD, see example request below

Returns an ExecutionsObject.

{
  "type": "rfqGetQuoteAck",
  "payload": {
    "quoteId": "b9593fd0-db2d-4e22-8c6b-2e9d5a3226f7",
    "quoteTime": 1657595867140,
    "expireTime": 1657595917140,
    "symbol": "BTC-USD",
    "side": "buy",
    "receiveCurrency": "BTC",
    "receiveQuantity": 0.0495602273,
    "deliverCurrency": "USD",
    "deliverQuantity": 1000,
    "price": 20177.47
  }
}

Create an RFQ quote

POST https://api.aquanow.io/trades/v1/createQuote

createQuote endpoint allows user to initiate an RFQ request to Aquanow and receive a quoteId and price that is valid during the lifetime of the RFQ.

NOTE: Either deliverQuantity or receiveQuantity must be specified. If both are specified, receiveQuantity will be considered for sell orders, and deliverQuantity will be considered for buy orders.

If order is not filled, request returns a 200 response with receiveQuantity and deliverQuantity set to 0.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK Create a quote using receiveQuantity

Returns an ExecutionsObject.

{
  "type": "rfqCreateQuoteAck",
  "payload": {
    "quoteId": "474a8cb0-0484-46d8-909e-1c1a65cd200d",
    "quoteTime": 1628112496153,
    "expireTime": 1628112508153,
    "symbol": "ETH-CAD",
    "side": "buy",
    "receiveCurrency": "ETH",
    "receiveQuantity": 0.1,
    "deliverCurrency": "CAD",
    "deliverQuantity": 340.45,
    "price": 3404.5
  }
}

200: OK Create a quote using deliverQuantity

Returns an ExecutionsObject.

{
  "type": "rfqCreateQuoteAck",
  "payload": {
    "quoteId": "be267600-edd8-4b61-8b85-528223d61e17",
    "quoteTime": 1628114160054,
    "expireTime": 1628114172054,
    "symbol": "ETH-CAD",
    "side": "buy",
    "receiveCurrency": "ETH",
    "receiveQuantity": 0.0292817194,
    "deliverCurrency": "CAD",
    "deliverQuantity": 100,
    "price": 3415.1
  }
}

200: OK Insufficient funds

Returns an ExecutionsObject.

{
  "type": "rfqCreateQuoteAck",
  "error": {
    "message": "Aqua: Insufficient funds"
  },
  "payload": {
    "quoteId": "33e0a6d6-f7be-4c6b-864e-a28510a3c474"
  }
}

400: Bad Request Invalid trade side

{
    "message": "Invalid tradeSide: buying"
}

400: Bad Request Invalid ticker

{
    "message": "Invalid ticker: ETH-CADD"
}

400: Bad Request Trade size below required minimum

{
    "message": "Trade size must be bigger than minimum size 1e-7. You submitted: 1e-8"
}

403: Forbidden User doesn't have trade permission

{
    "message": "Access Denied"
}

500: Internal Server Error Strategy not enabled

{
    "message": "You don't have permission to do this, contact [e-mail] if you have questions"
}

Execute an RFQ Quote

POST https://api.aquanow.io/trades/v1/executeQuote

executeQuote endpoint allows users to execute a trade with a specified quoteId with the symbol, trade side and size within the time to live (TTL) of the request associated with the quoteId.

NOTE: The quote must be executed BEFORE the time expired. The TTL of a quote is 8 seconds by default. If you wish to increase the expiry time, please contact Aquanow for support.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK

Returns an ExecutionsObject.

{
  "type": "rfqExecuteQuoteAck",
  "payload": {
    "quoteId": "205feb16-0135-401b-84ce-a27e12d42453"
  }
}

200: OK Expired quote

{
    "message": "The quote has already expired"
}

403: Forbidden User doesn't have trade permission

{
    "message": "Access Denied"
}

Expire an RFQ Quote

PUT https://api.aquanow.io/trades/v1/expireQuote

expireQuote endpoint allows users to expire a quote with a specified quoteId within the time to live (TTL) of the request associated with the quoteId.

NOTE: The quote must be executed BEFORE the time expired. The TTL of a quote is 8 seconds by default. If you wish to increase the expiry time, please contact Aquanow for support.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK

Returns an ExecutionsObject.

{
  "type": "rfqExpireQuoteAck",
  "payload": {
    "quoteId": "6d187635-27df-4175-8b23-f1f0ec84907e"
  }
}

400: Bad Request Expired or completed RFQ quote

{
  "message": "quoteId: 6d187635-27df-4175-8b23-f1f0ec84907e has alreaady been processed"
}

Market

Aquanow's Market execution strategy is utilized to perform instant executions.

Create a market order

POST https://api.aquanow.io/trades/v1/market

Note: Either deliverQuantity or receiveQuantity must be specified. If both are specified, receiveQuantity will be considered for sell orders, and deliverQuantity will be considered for buy orders.

If order is not filled, the request will return a 200 response, with receiveQuantity and deliverQuantity set to 0.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK Sell BTC with deliverQuantity

Returns an ExecutionsObject.

{
  "type": "marketOrderSubmitAck",
  "payload": {
    "orderId": "105bb0a7-fdb0-4bde-a367-d47787951349",
    "receiveCurrency": "USD",
    "receiveQuantity": 19.6206,
    "deliverCurrency": "BTC",
    "deliverQuantity": 0.002,
    "fee": 0.0392412
  }
}

200: OK Buy BTC with receiveQuantity

Returns an ExecutionsObject.

{
  "type": "marketOrderSubmitAck",
  "payload": {
    "orderId": "bd94982b-558a-4708-81fa-acbdae3073d0",
    "receiveCurrency": "BTC",
    "receiveQuantity": 0.048,
    "deliverCurrency": "USD",
    "deliverQuantity": 469.6272,
    "fee": 0.000096
  }
}

200: OK Order not filled

Returns an ExecutionsObject.

{
  "type": "marketOrderSubmitAck",
  "payload": {
    "orderId": "5ecfc1b2-cb8b-4a9c-8f95-0cf3081dc704",
    "receiveCurrency": "USD",
    "receiveQuantity": 0,
    "deliverCurrency": "BTC",
    "deliverQuantity": 0,
    "fee": 0
  }
}

400: Bad Request Missing receiveQuantity or deliverQuantity

{
    "message": "Either deliverQuantity or receiveQuantity must be specified, or must be bigger than 0"
}

400: Bad Request Invalid ticker

{
    "message": "Invalid ticker: BTC-USDD"
}

400: Bad Request Invalid trade side

{
    "message": "Invalid tradeSide: selling"
}

502: Bad Gateway Strategy not enabled

{
    "message": "User not authorized for MARKET"
}

403: Forbidden User doesn't have trade permission

{
    "message": "Access Denied"
}

200: OK Insufficient balance

Returns an ExecutionsObject.

{
  "type": "marketOrderSubmitAck",
  "payload": {
    "orderId": "5ecfc1b5-cb8b-4a9c-8f95-0cf3081dc704",
    "receiveCurrency": "USD",
    "receiveQuantity": 0,
    "deliverCurrency": "BTC",
    "deliverQuantity": 0,
    "fee": 0
  }
}

200: OK Trade size below required minimum

Returns an ExecutionsObject.

{
    "type": "marketOrderSubmitAck",
    "payload": {
        "orderId": "7c98627-488y-4ce7-acde-2de3f887q0d3",
        "receiveCurrency": "USD",
        "receiveQuantity": 1e-10,
        "deliverCurrency": "USDT",
        "deliverQuantity": 1e-10,
        "fee": 0
    }
}

TWAP

Aquanow's execution algorithm.

TWAP

Time-Weighted Average Price (TWAP) is used when buying or selling large amounts of digital assets over time, with the ability to choose the amount being sold and its time period.

Create an order

POST https://api.aquanow.io/trades/v1/order

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK TWAP Strategy

Returns an ExecutionsObject.

{
  "type": "parentOrderSubmitAck",
  "payload": {
    "orderId": "6215758c-38dc-4a9f-9647-023ef14f20bb"
  }
}

200: OK Insufficient funds

Returns an ExecutionsObject.

{
    "type": "parentOrderSubmitAck",
    "error": {
        "message": "Aqua: Insufficient funds"
    },
    "payload": {
        "orderId": "a731b28f-5bbc-4638-a6af-ec5bd556b379"
    }
}

400: Bad Request Invalid trade side

{
    "message": "Invalid tradeSide: buying"
}

400: Bad Request Invalid ticker

{
    "message": "Invalid ticker: BTC-USDD"
}

400: Bad Request Trade size below required minimum

{
    "message": "Trade size is smaller than minimum size 0.002"
}

403: Forbidden User doesn't have trade permission

{
    "message": "Access Denied"
}

502: Bad Gateway Strategy not enabled

{
    "message": "User not authorized for TWAP"
}

Cancel a pre-existing TWAP order.

DELETE https://api.aquanow.io/trades/v1/order

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Query Parameters

Headers

200: OK

Returns an ExecutionsObject.

{
  "type": "parentOrderCancelAck",
  "payload": {
    "orderId": "7b323a75-5457-450f-9bf0-46fa6f20ff4e"
  }
}

502: Bad Gateway Order not found

{
    "message": "You request is invalid, contact [e-mail] if you have questions"
}

FOK

Fill or Kill order strategy will execute the entire order immediately at the market or specified price, otherwise it will cancelled if not filled.

Endpoint to initiate a FOK request to Aquanow.

POST https://api.aquanow.io/trades/v1/order

NOTE: Either deliverQuantity, receiveQuantity must be specified. If both are specified, receiveQuantity will be considered for sell orders, and deliverQuantity will be considered for buy orders.

If order is not filled, the request will return a 200 response with a Cancelled message.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK Order filled successfully

Returns an ExecutionsObject.

{
  "type": "parentOrderSubmitAck",
  "payload": {
    "orderId": "0bea14b3-a510-437c-a805-73p15f654cad",
    "receiveCurrency": "BTC",
    "receiveQuantity": 0.02,
    "deliverCurrency": "USD",
    "deliverQuantity": 881.7,
    "fee": 0,
    "tradeTime": 1704389622301,
    "symbol": "BTC-USD",
    "tradeStatus": "COMPLETE",
    "price": 44085
  }
}

200: OK Insufficient funds

Returns an ExecutionsObject.

{
    "type": "parentOrderSubmitAck",
    "error": {
        "message": "Aqua: Insufficient funds"
    },
    "payload": {
        "orderId": "275661f3-beb1-4464-bf21-af0789632438",
        "receiveCurrency": "BTC",
        "receiveQuantity": 0,
        "deliverCurrency": "USD",
        "deliverQuantity": 0,
        "fee": 0,
        "tradeTime": 1704391973378,
        "symbol": "BTC-USD",
        "tradeStatus": "COMPLETE",
        "price": 45065.18509321
    }
}

200: OK Order not filled

Returns an ExecutionsObject.

{
    "type": "parentOrderSubmitAck",
    "error": {
        "message": "Cancelled - Price not marketable"
    },
    "payload": {
        "orderId": "50154c07-04d8-49ef-8a4c-392aa7014346",
        "receiveCurrency": "BTC",
        "receiveQuantity": 0,
        "deliverCurrency": "USD",
        "deliverQuantity": 0,
        "fee": 0,
        "tradeTime": 1704391943590,
        "symbol": "BTC-USD",
        "tradeStatus": "CANCELLED",
        "price": 44073.3
    }
}

400: Bad Request Invalid tradeSide

Returns an ExecutionsObject.

{
    "message": "data/tradeSide must be equal to one of the allowed values"
}

400: Bad Request Missing deliverQuantity and receiveQuantity

Returns an ExecutionsObject.

{
    "message": "provide at least one baseQuantity and quoteQuantity to be non-zero"
}

403: Forbidden User doesn't have trade permission

Returns an ExecutionsObject.

{
    "message": "User is not authorized to access this resource with an explicit deny"
}

502: Bad Gateway Strategy not enable

Returns an ExecutionsObject.

{
    "message": "User not authorized for FOK"
}

LIMIT/GTC/GTD

Aquanow's duration order algorithms with a price limit.

Orders can be completed immediately depending on the specified priceLimit, quantity and the market. Incomplete pre-existing orders expire depending on the strategy.

Duration Order Algorithms

LIMIT

LIMIT orders create a pre-existing order, available for up to 24 hours.

GTC

Good Till Cancel (GTC) orders create a pre-existing order, available for up to 90 days.

GTD

Good Till Date (GTD) orders create a pre-existing order, available until a specified expirationTime date (max. 90 days).

Endpoint to initiate an LIMIT/GTC/GTD request to Aquanow.

POST https://api.aquanow.io/trades/v1/order

NOTE: Either deliverQuantity or receiveQuantity must be specified. If both are specified, receiveQuantity will be considered for sell orders, and deliverQuantity will be considered for buy orders.

If order is not filled, the request will return a 200 response with receiveQuantity and deliverQuantity set to 0.

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK LIMIT buy BTC with receiveQuantity

Returns an ExecutionsObject.

{
  "type": "limitOrderAck",
  "payload": {
    "quoteId": "5cecaa55-e91a-4c12-9af4-756c9f3630ea",
    "quoteTime": 1669072974783,
    "expireTime": 1669159374783,
    "ticker": "BTC-USD",
    "tradeSide": "buy",
    "receiveCurrency": "BTC",
    "receiveQuantity": 0.048,
    "deliverCurrency": "USD",
    "deliverQuantity": 758.208,
    "price": 15796
  }
}

200: OK LIMIT sell BTC with deliverQuantity

Returns an ExecutionsObject.

{
  "type": "limitOrderAck",
  "payload": {
    "quoteId": "7202456e-36c6-44a6-8579-a2e86808deb0",
    "quoteTime": 1669072984056,
    "expireTime": 1669159384056,
    "ticker": "BTC-USD",
    "tradeSide": "sell",
    "receiveCurrency": "USD",
    "receiveQuantity": 805.44,
    "deliverCurrency": "BTC",
    "deliverQuantity": 0.048,
    "price": 16780
  }
}

200: OK GTC buy BTC with deliverQuantity

Returns an ExecutionsObject.

{
  "type": "parentOrderSubmitAck",
  "payload": {
    "orderId": "051065f6-0ad6-4ea6-8f08-85263bca42bc"
  }
}

200: OK GTC sell BTC with receiveQuantity

Returns an ExecutionsObject.

{
  "type": "parentOrderSubmitAck",
  "payload": {
    "orderId": "d0386efb-a72f-4ee0-b40f-552008f41c98"
  }
}

200: OK GTD buy BTC with deliverQuantity

Returns an ExecutionsObject.

{
  "type": "parentOrderSubmitAck",
  "payload": {
    "orderId": "bd0a5ce3-4437-4492-9942-8b1dcffb9227"
  }
}

200: OK GTD sell BTC with receiveQuantity

Returns an ExecutionsObject.

{
  "type": "parentOrderSubmitAck",
  "payload": {
    "orderId": "b50caa7e-92b0-408c-b68a-fe25822bc4b2"
  }
}

200: OK Insufficient funds

Returns an ExecutionsObject.

{
    "type": "limitOrderAck",
    "error": {
        "message": "Aqua: Insufficient funds"
    },
    "payload": {
        "orderId": "a731b28f-5bbc-4638-a6af-ec5bd556b379"
    }
}

400: Bad Request GTD order error, invalid expirationTime

{
    "message": "expirationTime should be within 90 days from now: 1869972405009"
}

400: Bad Request GTD order error, missing expirationTime

{
    "message": "data must have required property 'expirationTime'"
}

400: Bad Request Invalid ticker

{
    "message": "data/ticker must be equal to one of the allowed values"
}

400: Bad Request Invalid trade side

{
    "message": "data/tradeSide must be equal to one of the allowed values"
}

502: Bad Gateway Strategy not enabled

{
    "message": "User not authorized for LIMIT"
}

400: Bad Request Trade size below minimum

{
    "message": "Trade size must be bigger than minimum size 1e-7. You submitted: 1e-9"
}

403: Forbidden User doesn't have trade permission

{
    "message": "Access Denied"
}

Cancel a pre-existing LIMIT/GTC/GTD order.

DELETE https://api.aquanow.io/trades/v1/order

To view example requests for this endpoint, visit Aquanow's Postman documentation.

Headers

Request Body

200: OK

Returns an ExecutionsObject.

{
    "type": "parentOrderCancelAck",
    "payload": { 
        "orderId": "7b323a75-5457-450f-9bf0-46fa6f20ff4e"
    }
}

502: Bad Gateway Invalid orderId

{
    "message": "You request is invalid, contact [e-mail] if you have questions"
}