Executions API
Aquanow provides execution services to end users by leveraging our aggregated market data, liquidity, and execution algorithms.
Get or query orders
GET
https://api.aquanow.io/trades/v1/order
To view example requests for this endpoint, visit Aquanow's Postman documentation.
NOTE: The limit for this endpoint is a maximum payload of 5 mb. For larger payloads, use the v2 endpoint or change the time range parameters to query for less results.
Query Parameters
Headers
Returns an OrdersObject.
{
"orderId": "905910d8-ad90-42f6-91af-910defeae2ad",
"remainingQtyBase": 0,
"tradeSize": 0.1,
"exchangeOrderId": "-",
"tradePriceAvg": 71874.9,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712618352305,
"childOrderCount": 0,
"itemDateTime": 1712618353772,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 0.1,
"usernameRef": "-",
"fillQtyBase": 7187.49,
"accountId": "CA1000101R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712618352379,
"message": "-",
"priceLimit": 71874.9,
"quoteSymbol": "BTC",
"remainingQtyQuote": 0,
"orderIdParent": "905910d8-ad90-42f6-91af-910defeae2ad",
"orderType": "parentOrder",
"updatedAt": 1712618353772,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
}
Returns an array of OrdersObject.
[
{
"orderId": "905910d8-ad90-42f6-91af-910defeae2ad",
"remainingQtyBase": 0,
"tradeSize": 0.1,
"exchangeOrderId": "-",
"tradePriceAvg": 71874.9,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712618352305,
"childOrderCount": 0,
"itemDateTime": 1712618353772,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 0.1,
"usernameRef": "-",
"fillQtyBase": 7187.49,
"accountId": "CA1000051R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712618352379,
"message": "-",
"priceLimit": 71874.9,
"quoteSymbol": "BTC",
"remainingQtyQuote": 0,
"orderIdParent": "905910d8-ad90-42f6-91af-910defeae2ad",
"orderType": "parentOrder",
"updatedAt": 1712618353772,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "b6cf97fb-f906-4fef-a12e-a320e34c2527",
"remainingQtyBase": 0,
"tradeSize": 100,
"exchangeOrderId": "-",
"tradePriceAvg": 1,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712615969854,
"childOrderCount": 0,
"itemDateTime": 1712615971165,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 100,
"usernameRef": "-",
"fillQtyBase": 100,
"accountId": "CA1000051R",
"exchangePair": "aquax-USDT-USD",
"symbol": "USDT-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712615969901,
"message": "-",
"priceLimit": 1,
"quoteSymbol": "USDT",
"remainingQtyQuote": 0,
"orderIdParent": "b6cf97fb-f906-4fef-a12e-a320e34c2527",
"orderType": "parentOrder",
"updatedAt": 1712615971165,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "e76ed244-6a72-464c-beff-6f57f7c7978c",
"remainingQtyBase": 0,
"tradeSize": 0.0836481758,
"exchangeOrderId": "-",
"tradePriceAvg": 71729,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "sell",
"exchangeClientOrderId": "-",
"tradeTime": 1712615254394,
"childOrderCount": 0,
"itemDateTime": 1712615255735,
"baseSymbol": "BTC",
"strategy": "RFQ",
"fillQtyQuote": 6000,
"usernameRef": "-",
"fillQtyBase": 0.0836481758,
"accountId": "CA1000051R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712615254433,
"message": "-",
"priceLimit": 71729,
"quoteSymbol": "USD",
"remainingQtyQuote": 0,
"orderIdParent": "e76ed244-6a72-464c-beff-6f57f7c7978c",
"orderType": "parentOrder",
"updatedAt": 1712615255735,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "242aa1e3-3bc4-4725-a4ec-781739cd8431",
"remainingQtyBase": 0,
"tradeSize": 1,
"exchangeOrderId": "-",
"tradePriceAvg": 3689.65,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "sell",
"exchangeClientOrderId": "-",
"tradeTime": 1712610345382,
"childOrderCount": 0,
"itemDateTime": 1712610346741,
"baseSymbol": "ETH",
"strategy": "RFQ",
"fillQtyQuote": 3689.65,
"usernameRef": "-",
"fillQtyBase": 1,
"accountId": "CA1000051R",
"exchangePair": "aquax-ETH-USD",
"symbol": "ETH-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712610345395,
"message": "-",
"priceLimit": 3689.65,
"quoteSymbol": "USD",
"remainingQtyQuote": 0,
"orderIdParent": "242aa1e3-3bc4-4725-a4ec-781739cd8431",
"orderType": "parentOrder",
"updatedAt": 1712610346741,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "8004ae83-d201-4b10-8881-364f84f7d678",
"remainingQtyBase": 0,
"tradeSize": 0.1,
"exchangeOrderId": "-",
"tradePriceAvg": 71755.72,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712610305889,
"childOrderCount": 0,
"itemDateTime": 1712610307488,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 0.1,
"usernameRef": "-",
"fillQtyBase": 7175.572,
"accountId": "CA1000051R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712610305967,
"message": "-",
"priceLimit": 71755.72,
"quoteSymbol": "BTC",
"remainingQtyQuote": 0,
"orderIdParent": "8004ae83-d201-4b10-8881-364f84f7d678",
"orderType": "parentOrder",
"updatedAt": 1712610307488,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "1848e32b-f5c8-406d-9119-62b20fc4436d",
"remainingQtyBase": 0,
"tradeSize": 0,
"exchangeOrderId": "-",
"tradePriceAvg": 107.82,
"fillPct": 100,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1703717118309,
"childOrderCount": 0,
"baseSymbol": "USD",
"strategy": "FOK",
"fillQtyQuote": 0,
"usernameRef": "-",
"fillQtyBase": 0,
"accountId": "CA1000051R",
"exchangePair": "--SOL-USD",
"symbol": "SOL-USD",
"tradeStatus": "CANCELLED",
"commissionRate": 0,
"createdAt": 1703717118312,
"message": "Cancelled - Price not marketable",
"priceLimit": 107.72,
"quoteSymbol": "SOL",
"remainingQtyQuote": 0,
"orderIdParent": "1848e32b-f5c8-406d-9119-62b20fc4436d",
"orderType": "parentOrder",
"updatedAt": 1703717118312,
"exchange": "-",
"tradeDuration": 0,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "741e4cf0-44c3-457d-ad70-8c28d5f5cfa4",
"remainingQtyBase": 0,
"tradeSize": 1,
"exchangeOrderId": "-",
"tradePriceAvg": 108.03,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1703717081374,
"childOrderCount": 0,
"itemDateTime": 1703717084055,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 1,
"usernameRef": "-",
"fillQtyBase": 108.03,
"accountId": "CA1000051R",
"exchangePair": "aquax-SOL-USD",
"symbol": "SOL-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1703717081443,
"message": "-",
"priceLimit": 108.03,
"quoteSymbol": "SOL",
"remainingQtyQuote": 0,
"orderIdParent": "741e4cf0-44c3-457d-ad70-8c28d5f5cfa4",
"orderType": "parentOrder",
"updatedAt": 1703717084056,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
}
]
Returns an array of OrdersObject.
[
{
"orderId": "905910d8-ad90-42f6-91af-910defeae2ad",
"remainingQtyBase": 0,
"tradeSize": 0.1,
"exchangeOrderId": "-",
"tradePriceAvg": 71874.9,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712618352305,
"childOrderCount": 0,
"itemDateTime": 1712618353772,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 0.1,
"usernameRef": "-",
"fillQtyBase": 7187.49,
"accountId": "CA1000051R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712618352379,
"message": "-",
"priceLimit": 71874.9,
"quoteSymbol": "BTC",
"remainingQtyQuote": 0,
"orderIdParent": "905910d8-ad90-42f6-91af-910defeae2ad",
"orderType": "parentOrder",
"updatedAt": 1712618353772,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "b6cf97fb-f906-4fef-a12e-a320e34c2527",
"remainingQtyBase": 0,
"tradeSize": 100,
"exchangeOrderId": "-",
"tradePriceAvg": 1,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712615969854,
"childOrderCount": 0,
"itemDateTime": 1712615971165,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 100,
"usernameRef": "-",
"fillQtyBase": 100,
"accountId": "CA1000051R",
"exchangePair": "aquax-USDT-USD",
"symbol": "USDT-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712615969901,
"message": "-",
"priceLimit": 1,
"quoteSymbol": "USDT",
"remainingQtyQuote": 0,
"orderIdParent": "b6cf97fb-f906-4fef-a12e-a320e34c2527",
"orderType": "parentOrder",
"updatedAt": 1712615971165,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "e76ed244-6a72-464c-beff-6f57f7c7978c",
"remainingQtyBase": 0,
"tradeSize": 0.0836481758,
"exchangeOrderId": "-",
"tradePriceAvg": 71729,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "sell",
"exchangeClientOrderId": "-",
"tradeTime": 1712615254394,
"childOrderCount": 0,
"itemDateTime": 1712615255735,
"baseSymbol": "BTC",
"strategy": "RFQ",
"fillQtyQuote": 6000,
"usernameRef": "-",
"fillQtyBase": 0.0836481758,
"accountId": "CA1000051R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712615254433,
"message": "-",
"priceLimit": 71729,
"quoteSymbol": "USD",
"remainingQtyQuote": 0,
"orderIdParent": "e76ed244-6a72-464c-beff-6f57f7c7978c",
"orderType": "parentOrder",
"updatedAt": 1712615255735,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "242aa1e3-3bc4-4725-a4ec-781739cd8431",
"remainingQtyBase": 0,
"tradeSize": 1,
"exchangeOrderId": "-",
"tradePriceAvg": 3689.65,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "sell",
"exchangeClientOrderId": "-",
"tradeTime": 1712610345382,
"childOrderCount": 0,
"itemDateTime": 1712610346741,
"baseSymbol": "ETH",
"strategy": "RFQ",
"fillQtyQuote": 3689.65,
"usernameRef": "-",
"fillQtyBase": 1,
"accountId": "CA1000051R",
"exchangePair": "aquax-ETH-USD",
"symbol": "ETH-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712610345395,
"message": "-",
"priceLimit": 3689.65,
"quoteSymbol": "USD",
"remainingQtyQuote": 0,
"orderIdParent": "242aa1e3-3bc4-4725-a4ec-781739cd8431",
"orderType": "parentOrder",
"updatedAt": 1712610346741,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
},
{
"orderId": "8004ae83-d201-4b10-8881-364f84f7d678",
"remainingQtyBase": 0,
"tradeSize": 0.1,
"exchangeOrderId": "-",
"tradePriceAvg": 71755.72,
"fillPct": 100,
"finalizeReturnedQtyBase": 0,
"tradeSide": "buy",
"exchangeClientOrderId": "-",
"tradeTime": 1712610305889,
"childOrderCount": 0,
"itemDateTime": 1712610307488,
"baseSymbol": "USD",
"strategy": "RFQ",
"fillQtyQuote": 0.1,
"usernameRef": "-",
"fillQtyBase": 7175.572,
"accountId": "CA1000051R",
"exchangePair": "aquax-BTC-USD",
"symbol": "BTC-USD",
"tradeStatus": "COMPLETE",
"commissionRate": 0,
"createdAt": 1712610305967,
"message": "-",
"priceLimit": 71755.72,
"quoteSymbol": "BTC",
"remainingQtyQuote": 0,
"orderIdParent": "8004ae83-d201-4b10-8881-364f84f7d678",
"orderType": "parentOrder",
"updatedAt": 1712610307488,
"exchange": "aquax",
"tradeDuration": 30,
"username": "helloWorld",
"fillFeeQuoteAqua": 0
}
]
{
"Item": null
}
{
"message": "Unauthorized"
}
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
Returns an ExecutionsObject.
{
"type": "limitOrderAck",
"payload": {
"accountId": "CA1000051R",
"quoteId": "7a9f51df-f81c-442f-b8e9-68527c23f826",
"quoteTime": 1712769019504,
"expireTime": 1712855419504,
"ticker": "USDT-USD",
"tradeSide": "buy",
"receiveCurrency": "USDT",
"receiveQuantity": 10,
"deliverCurrency": "USD",
"deliverQuantity": 10.0005,
"price": 1.048179
}
}
Returns an ExecutionsObject.
{
"type": "limitOrderAck",
"payload": {
"accountId": "CA1000051R",
"quoteId": "b04240dc-8147-4ec9-b1f1-42db8fc266ee",
"quoteTime": 1712769099215,
"expireTime": 1712855499215,
"ticker": "USDT-USD",
"tradeSide": "buy",
"receiveCurrency": "USDT",
"receiveQuantity": 9.999500025,
"deliverCurrency": "USD",
"deliverQuantity": 10,
"price": 1.048179
}
}
Returns an ExecutionsObject.
{
"type": "gtcOrderAck",
"payload": {
"accountId": "CA1000051R",
"quoteId": "c1e5afee-31cd-4298-a5bb-1a522783ef1d",
"quoteTime": 1712770842387,
"expireTime": 1720546842387,
"ticker": "BTC-USD",
"tradeSide": "sell",
"receiveCurrency": "USD",
"receiveQuantity": 7078,
"deliverCurrency": "BTC",
"deliverQuantity": 0.1,
"price": 70780
}
}
Returns an ExecutionsObject.
{
"type": "gtcOrderAck",
"payload": {
"accountId": "CA1000051R",
"quoteId": "5fc3a630-b4f5-45e2-8ec7-ef4a2bab8259",
"quoteTime": 1712771653681,
"expireTime": 1720547653681,
"ticker": "BTC-USD",
"tradeSide": "sell",
"receiveCurrency": "USD",
"receiveQuantity": 100,
"deliverCurrency": "BTC",
"deliverQuantity": 0.0014128285,
"price": 70780
}
}
Returns an ExecutionsObject.
{
"type": "gtdOrderAck",
"payload": {
"accountId": "CA1000051R",
"quoteId": "2d280c0e-2dfc-4322-a81d-0aafe39f6e9a",
"quoteTime": 1712771907218,
"expireTime": 1715375035218,
"ticker": "BTC-USD",
"tradeSide": "sell",
"receiveCurrency": "USD",
"receiveQuantity": 7078,
"deliverCurrency": "BTC",
"deliverQuantity": 0.1,
"price": 70780
}
}
Returns an ExecutionsObject.
{
"type": "gtdOrderAck",
"payload": {
"accountId": "CA1000051R",
"quoteId": "f71ecdec-389f-4c90-a9a7-b9d250d0b2f6",
"quoteTime": 1712771799855,
"expireTime": 1715375035855,
"ticker": "BTC-USD",
"tradeSide": "sell",
"receiveCurrency": "USD",
"receiveQuantity": 100,
"deliverCurrency": "BTC",
"deliverQuantity": 0.0014128285,
"price": 70780
}
}
Returns an ExecutionsObject.
{
"type": "limitOrderAck",
"error": {
"message": "Aqua: Insufficient funds"
},
"payload": {
"orderId": "a731b28f-5bbc-4638-a6af-ec5bd556b379"
}
}
{
"message": "expirationTime should be within 90 days from now: 1869972405009"
}
{
"message": "data must have required property 'expirationTime'"
}
{
"message": "data/ticker must be equal to one of the allowed values"
}
{
"message": "Trade size must be bigger than minimum size 1e-7. You submitted: 1e-9"
}
{
"message": "data/tradeSide must be equal to one of the allowed values"
}
{
"message": "Access Denied"
}
{
"message": "User not authorized for LIMIT"
}
Last updated