Trade

Note: All trading calls need to be authorized against your AIO Exchange account before processing any request, refer to the Authentication tab for more details.

Request A Quote

Queries each exchange and returns the best quote corresponding to parameters.

POST https://api.aio.exchange/api/v2/trade/requestquote

Each exchange orderbook is queried and blockchains analyzed according to parameters.

Request Body

Name	Type	Description
side*	String	"buy" or "sell"
executionType*	Integer	1 = Best Execution 2 = Quickest Best Execution 3 = Instant Settlement
orderType*	String	"Market", "Limit" or "Stop"
baseAmount	Decimal	This refers to the (base) amount in terms of the first part of the ticker pair. i.e. if BTC-USDT ({BaseSymbol}-{TargetSymbol} is requested, the baseAmount refers to the amount in BTC. This parameter can be used for both "buy" and "sell" orders. *If this parameter is not provided, targetAmount is required.
baseTokenId	Integer	Unique Token Identifier *If this parameter is not provided, baseTokenSymbol is required.
targetTokenId	Integer	Unique Token Identifier *If this parameter is not provided, targetTokenSymbol is required.
sources	String[]	Array of exchangeIds to filter quotes. Available value include ["BINANCE", "BITFINEX", "BITMART", "BITMART", "BITSTAMP", "BITTREX", "CEX", "COINBASE", "COINMETRO", "CRYPTOCOM", "GATE", "HUOBI", "KRAKEN", "KUCOIN", "OKX", "OKCOIN", "PROBIT"]
targetAmount	Decimal	This refers to the (base) amount in terms of the first part of the ticker pair. i.e. if BTC-USDT ({BaseSymbol}-{TargetSymbol} is requested, the targetAmount refers to the amount in USDT. This parameter can be used for both "buy" and "sell" orders. *If this parameter is not provided, baseAmount is required.
targetTokenSymbol	String	ticker of quote currency (e.g. "BTC") *If this parameter is not provided, targetCoinId is required.
baseTokenSymbol	String	ticker of base currency (e.g. "BTC") *If this parameter is not provided, baseCoinId is required.

200: OK

{
   "data":{
      "enforceMasterBalance":true,
      "id":1459,
      "quoteId":"AIOQ908536F9207349BA99C66",
      "side":"SELL",
      "executionType":1,
      "orderType":"MARKET",
      "status":"QUOTED",
      "baseAmount":1.27914,
      "targetAmount":25.0,
      "rate":20.17,
      "baseTokenSymbol":"SOL",
      "targetTokenSymbol":"USDT", 
      "baseTokenId":3956,
      "targetTokenId":4276,
      "makerFee":0.0,
      "takerFee":0.0,
      "aioFee":5.0,
      "totalFee":1.8357,
      "chain":"SPL-SPL",
      "exchange":"BINANCE",
      "estSettlementTimeSecs":146,
      "expiryTime":"1/1/1900 12:00:00 AM",
      "dateCreated":"4/9/2023 11:54:55 AM",
      "dateModified":"4/9/2023 11:54:58 AM",
      "sources":null
   },
   "success":true,
   "timestamp":1681041295072,
   "requestId":"511203ff-3999-4f3d-ac1c-045d02cbd855",
   "message":"",
   "error":null
}

Accept A Quote

Accept Quote (Place Order)

POST https://api.aio.exchange/api/v2/trade/acceptquote

Request Body

Name	Type	Description
quoteId*	String	Id Of The Quote To Accept
MaxTimeout	Int	Default: 20 seconds Maximum: 60 seconds

200: OK

{
   "data":{
      "orderId":"e8952605-4bc2-4039-a133-4e3gk513afd4c",// for API orders 
      "quoteId":"AIOQ908536F9207349BA99C66",
      "timestampCreated":1668931096371,
   },
   "success":true,
   "timestamp":1681041295072,
   "requestId":"511203ff-3999-4f3d-ac1c-04364564sg55",
   "message":"",
   "error":null
}

Get Order Detail

Order placed using accept a quote can be retrieved using order id.

GET https://api.aio.exchange/api/v2/trade/orderdetail/{orderId}

Eg. https://api.aio.exchange/api/v2/trade/orderdetail/e8952605-4bc2-4039-a133-4e3gk513afd4c

Path Parameters

Name	Type	Description
orderId	string	orderId retrieved from previous Accept Quote call

200: OK

{
   "data":{
      "orderId":"e8952605-4bc2-4039-a133-4e3gk513afd4c",
      "quoteId":"AIOQ908536F9207349BA99C66",
      "orderStatus":"ERROR NO BALANCE",
      "baseSymbol":"SOL",
      "targetSymbol":"USDT",
      "exchange":"BINANCE",
      "side":"SELL",
      "orderSize":null,
      "received":0.0,
      "receivedSymbol":"USDT",
      "depositMethod":{
         "network":"SPL",
         "amount":1.26907,
         "symbol":"SOL",
         "transactionId":"",
         "fee":0.0000100000,
         "FeeSymbol":"SOL"
      },
      "withdrawMethod":{
         "network":"SPL",
         "amount":0.0,
         "symbol":"USDT",
         "transactionId":"",
         "fee":0.8000000000,
         "FeeSymbol":"USDT"
      },
      "aioFee":5.0000000000,
      "aioFeeSymbol":"AIO",
      "dateCreated":"4/8/2023 6:06:30 PM",
      "dateModified":"4/8/2023 6:06:30 PM"
   },
   "success":true,
   "timestamp":1681041677918,
   "requestId":"72b4bb7c-f00d-488d-9945-9212ca07b31a",
   "message":"",
   "error":null
}

Get All Order Details

All orders placed within the account can be retrieved using above request. API will return the last 50 orders. Older order can be fetched using the page number, each request will return a maximum of 50 orders.

GET https://api.aio.exchange/api/v2/trade/orderdetails

Eg. https://api.aio.exchange/api/v2/trade/orderdetails ,

https://api.aio.exchange/api/v2/trade/orderdetails/{pagenumber}

Path Parameters

Name	Type	Description
pagenumber	integer	maximum order per request is 50, any later order can be fetched by passing the page number, if page number not passed, default it will return first page

200: OK

{
   "data":[{
      "orderId":"e8952605-4bc2-4039-a133-4e3gk513afd4c",
      "quoteId":"AIOQ908536F9207349BA99C66",
      "orderStatus":"ERROR NO BALANCE",
      "baseSymbol":"SOL",
      "targetSymbol":"USDT",
      "exchange":"BINANCE",
      "side":"SELL",
      "orderSize":null,
      "received":0.0,
      "receivedSymbol":"USDT",
      "depositMethod":{
         "network":"SPL",
         "amount":1.26907,
         "symbol":"SOL",
         "transactionId":"",
         "fee":0.0000100000,
         "FeeSymbol":"SOL"
      },
      "withdrawMethod":{
         "network":"SPL",
         "amount":0.0,
         "symbol":"USDT",
         "transactionId":"",
         "fee":0.8000000000,
         "FeeSymbol":"USDT"
      },
      "aioFee":5.0000000000,
      "aioFeeSymbol":"AIO",
      "dateCreated":"4/8/2023 6:06:30 PM",
      "dateModified":"4/8/2023 6:06:30 PM"
   },
   {
      "orderId":"34df505-4bc2-4039-a133-4e3gk513afd4c",
      "quoteId":"AIOQ908536F9207349BA99C66",
      "orderStatus":"ERROR NO BALANCE",
      "baseSymbol":"SOL",
      "targetSymbol":"USDT",
      "exchange":"BINANCE",
      "side":"SELL",
      "orderSize":null,
      "received":0.0,
      "receivedSymbol":"USDT",
      "depositMethod":{
         "network":"SPL",
         "amount":1.26907,
         "symbol":"SOL",
         "transactionId":"",
         "fee":0.0000100000,
         "FeeSymbol":"SOL"
      },
      "withdrawMethod":{
         "network":"SPL",
         "amount":0.0,
         "symbol":"USDT",
         "transactionId":"",
         "fee":0.8000000000,
         "FeeSymbol":"USDT"
      },
      "aioFee":5.0000000000,
      "aioFeeSymbol":"AIO",
      "dateCreated":"4/8/2023 6:06:30 PM",
      "dateModified":"4/8/2023 6:06:30 PM"
   }],
   "success":true,
   "timestamp":1681041677918,
   "requestId":"72b4bb7c-f00d-488d-9945-9212ca07b31a",
   "message":"",
   "error":null
}