Market Data

Market Data Overview

Gets an overview of market data for a given base and target.

GET https://api.aio.exchange/api/v2/marketdata/{baseTokenId}-{targetTokenId}

*Recommended

OR

GET https://api.aio.exchange/api/v2/marketdata/{baseSymbol}-{targetSymbol}

This is a public endpoint. Provides the best bid, the best ask, and live market information.

Path Parameters

Name	Type	Description
baseSymbol	String	Ticker Pair of the base currency e.g. for Bitcon: BTC
targetSymbol	String	Ticker Pair of the target currency e.g. for Tether: USDT
baseTokenId	Int	Token ID of the base currency e.g. for Bitcoin: 1
targetTokenId	Int	Token ID of the target currency e.g. for Tether: 825

200: OK /api/v1/marketdata/btc-usdt

// GET  Response

{
  "data": {
    "aggregatedVolume": 116132.8442178152, // sum of volume from connections 
    "high": 19176.3, // overall high 24h
    "low": 16574.4, // overall low 24h
    "baseSymbol": "BTC",
    "targetSymbol": "USDT",
    "baseTokenId": 1, //Unique AIO ID for token
    "targetTokenId": 825,
    "bestBid": {
      "exchangeName": "OKCOIN",
      "price": 16692.6,
      "size": 0.0056
    },
    "bestAsk": {
      "exchangeName": "BITSTAMP",
      "price": 16713,
      "size": 0
    },
    "dailyChange": 84.59939, //24h
    "dailyPercentageChange": 0.5081060598 //24h
  },
  "success": true,
  "error": null,
  "timestamp": 1668931096371,
  "requestId":"1234"
}

To Complete: Retrieves a snapshot of tickers across all exchanges.

GET https://api.aio.exchange/api/v2/marketdata/snapshot/{baseTokenId}-{targetTokenId}

Get's the last stored data from each exchange ticker

Path Parameters

Name	Type	Description
baseTokenId	Int	Token ID of the base currency e.g. for Bitcon: 1
targetTokenId	Int	Token ID of the target currency e.g. for Tether: 825

200: OK

{
  "response":
     data:[ {
        "exchangeName": "BINANCE",
        "bestAsk": 21934.50,
        "bestAskSize": 14.291,
        "bestBid": 21931.30,
        "bestBidSize": 12.21,
        "lastPrice": 21941.30,
        "volume":559357.12
      }, {
        "exchangeName": "BITFINEX",
        "bestAsk": 21930.20,
        "bestAskSize": 7.241,
        "bestBid": 21927.10,
        "bestBidSize": 1.78,
        "lastPrice": 21941.30,
        "volume":11555
      }, {
        "exchangeName": "BITMART",
        "bestAsk": 21934.50,
        "bestAskSize": 4.291,
        "bestBid": 21931.30,
        "bestBidSize": 1.2,
        "lastPrice": 21941.30,
        "volume":559357
      }, {
        "exchangeName": "BITSTAMP",
        "bestAsk": 21934.50,
        "bestAskSize": 4.291,
        "bestBid": 21931.30,
        "bestBidSize": 1.2,
        "lastPrice": 21941.30,
        "volume":559357
      },
      ...
      ],
      
      "maxCutOff":5000 // this is the number of milliseconds before we stop returning data for that exchange
      
     },   
  "success": true,
  "error": null,
  "timestamp": 1668931096371,
  "requestId":"1234"

}

Retrieves information about a specific token, and relevant metadata

GET https://api.aio.exchange/api/v2/marketdata/tokeninformation/{symbol}

Path Parameters

Name	Type	Description
symbol*	String	Ticker symbol of the currency e.g. for Bitcon: BTC

200: OK

{
    "data":
    [{
        "tokenId":132,
        "coinId":781,
        "name":"Cardano",
        "ticker":"ADA",
        "description":"Cardano (ADA) is a cryptocurrency launched in 2017. Cardano has a current supply of 35,538,184,453.812 with 34,670,947,960.302 in circulation. The last known price of Cardano is 0.3296321 USD and is down -7.69 over the last 24 hours. It is currently trading on 661 active market(s) with $316,529,610.18 traded over the last 24 hours. More information can be found at https://www.cardano.org.",
        "logoURL":"https://s2.coinmarketcap.com/static/img/coins/64x64/2010.png",
        "website":"https://www.cardano.org",
        "rank":7,
        "marketCap":11424034959.8761980000,
        "dilutedMarketCap":14827444977.3600000000,
        "aioConnectedExchanges":11
    }],
  "success": true,
  "error": null,
  "timestamp": 1668931096371,
  "requestId":"1234"
}