GET
/
depth
/
bid-ask-spread
Bid Ask Spread
curl --request GET \
  --url https://api.amberdata.com/markets/spot/analytics/depth/bid-ask-spread \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "data": [
      {
        "bestAskPrice": 96589.6,
        "bestBidPrice": 96222.19,
        "exchange": "binanceus",
        "midPrice": 96405.895,
        "pair": "btc_usd",
        "spread": 367.4100000000035,
        "spreadPercent": 0.3811074001232015,
        "timestamp": 1746144000000
      },
      {
        "bestAskPrice": 96524.98,
        "bestBidPrice": 96523.62,
        "exchange": "gdax",
        "midPrice": 96524.29999999999,
        "pair": "btc_usd",
        "spread": 1.360000000000582,
        "spreadPercent": 0.0014089716268344678,
        "timestamp": 1746144000000
      },
      {
        "bestAskPrice": 96469.9,
        "bestBidPrice": 96469.8,
        "exchange": "kraken",
        "midPrice": 96469.85,
        "pair": "btc_usd",
        "spread": 0.09999999999126885,
        "spreadPercent": 0.00010365932982301604,
        "timestamp": 1746144000000
      },
      {
        "bestAskPrice": 96504.1,
        "bestBidPrice": 96486.8,
        "exchange": "okex",
        "midPrice": 96495.45000000001,
        "pair": "btc_usd",
        "spread": 17.30000000000291,
        "spreadPercent": 0.017928306464193813,
        "timestamp": 1746144000000
      },
      {
        "bestAskPrice": 96589.61,
        "bestBidPrice": 96222.19,
        "exchange": "binanceus",
        "midPrice": 96405.9,
        "pair": "btc_usd",
        "spread": 367.41999999999825,
        "spreadPercent": 0.3811177531665575,
        "timestamp": 1746143940000
      },
      {
        "bestAskPrice": 96537.56,
        "bestBidPrice": 96537.55,
        "exchange": "gdax",
        "midPrice": 96537.555,
        "pair": "btc_usd",
        "spread": 0.00999999999476131,
        "spreadPercent": 0.000010358663004010523,
        "timestamp": 1746143940000
      }
    ]
  }
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
pair
string
default:btc_usd
required

[Required] The currency pair for the spot instrument. [Examples] btc_usd | btc_usdc | eth_usd

​
fuzzyMatch
boolean
default:false
required

[Required] This parameter allows users to return either a specific pair, such as btc_usd, when set to FALSE, or return every pair related to an underlying asset, such as BTC, when set to TRUE (ex: btc_eur, btc_usd, btc_usdt, etc)

​
exchange
string

[Optional] The exchange for the associated bid ask spread. [Examples] gdax | okex | binance | binanceus

​
startDate
string
default:2025-05-01

[Optional] Payload only includes data after this date (inclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2025-02-27

​
endDate
string
default:2025-05-02

[Optional] Payload only includes data up to this date (exclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2025-02-28

​
timeFormat
string
default:hr

[Optional] Time format of the timestamps in the return payload. [Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200
application/json

200

The response is of type any.