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

NameTypeDescription

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.

{
   "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

NameTypeDescription

quoteId*

String

Id Of The Quote To Accept

MaxTimeout

Int

Default: 20 seconds

Maximum: 60 seconds

{
   "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

NameTypeDescription

orderId

string

orderId retrieved from previous Accept Quote call

{
   "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

NameTypeDescription

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

{
   "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
}

Last updated