Skip to main content

​
Price Updates

​
Request

All pairs: 
{"jsonrpc":"2.0","id":1,"method":"subscribe","params":["market:spot:prices:updates"]}
Specific pair or pair & exchange: 
{"jsonrpc":"2.0","id":1,"method":"subscribe","params":["market:spot:prices:updates",{"pair":"btc_usdt"}]}
ParamTypeDescription
pairstringThe asset pair by which to filter.

​
Response

{
    "jsonrpc": "2.0",
    "method": "subscription",
    "params": {
        "result": {
            "delistedPair": false,
            "delta": "-4.8437252449679828865397170717",
            "isNewPair": false,
            "pair": "btc_usdt",
            "previousPrice": "67289.46636745258833937719",
            "previousTimestamp": 1712237940000,
            "price": "67284.6226422076203564906502829283",
            "timestamp": 1712238000000,
            "unchangedPrice": false
        },
        "subscription": "a931528473328abe28708cbe90f4183bff898dd213fe0ef7c2e7747b71b5d615"
    }
}
FieldTypeDescription
delistedPairbooltrue if pair has been delisted. false otherwise.
deltaThe dollar value change in price since last update.
isNewPairbooltrue if pair is new. false otherwise.
pairstringThe pair.
previousPriceThe price at time of last update.
previousTimestampThe time of the last update.
pricenumberThe quote price of the asset pair.
timestampnumberThe time at which the price change took place.
unchangedPricebooltrue if price hasn’t changed since last update. false otherwise.

​
Example

const WebSocket = require('ws');
const ws = new WebSocket('wss://ws.amberdata.io', {headers: {x-api-key:'<api_key>'}});

ws.on('open', () => {
  ws.send(JSON.stringify({
      jsonrpc: '2.0',
      method: 'subscribe',
      params: ["market:spot:prices:updates",{ "pair": "ltc_usdt"}],
      id: 1,
    }));
});

ws.on('message', data => {
  console.log(JSON.stringify(JSON.parse(data), null, 2));
});

​
Prices

​
Request

All pairs: 
{"jsonrpc":"2.0","id":1,"method":"subscribe","params":["market:spot:prices"]}
Specific pair or pair & exchange: 
{"jsonrpc":"2.0","id":1,"method":"subscribe","params":["market:spot:prices",{ "pair": "ltc_usdt"}]}
ParamTypeDescription
pairstringThe asset pair by which to filter.

​
Response

{
    "jsonrpc": "2.0",
    "method": "subscription",
    "params": {
        "result": {
            "pair": "akt_eur",
            "price": "3.93400000000000000000",
            "timestamp": 1712237820000
        },
        "subscription": "ed372faab21477c26eeedec5980c1e2a318ff2c58d0e0926dde94b6afa7e8e27"
    }
}
FieldTypeDescription
pairstringThe pair.
pricenumberThe quote price of the asset pair.
timestampnumberThe time at which the price change took place.

​
Example

const WebSocket = require('ws');
const ws = new WebSocket('wss://ws.amberdata.io', {headers: {x-api-key:'<api_key>'}});

ws.on('open', () => {
  ws.send(JSON.stringify({
      jsonrpc: '2.0',
      method: 'subscribe',
      params: ["market:spot:prices",{ "pair": "ltc_usdt"}],
      id: 1,
    }));
});

ws.on('message', data => {
  console.log(JSON.stringify(JSON.parse(data), null, 2));
});