Aggregated Orderbooks

Retrieves a list of aggregated orderbooks for a given cryptocurrency on a given timeframe.

Supported timeframes:

"5m", "15m", "1h", "4h", "1d" -> Will return one entry per interval of given timeframe

We aggregate spot orderbooks from every single major crypto CEX, orderbooks have a depth of 30% above and below price. Exchanges supported: (any exchange request? Ask us on Discord)

Binance, OKX, Kraken, Bitfinex, Bybit, MEXC, Bitget, KuCoin, Upbit, Gate.io, Coinbase Pro, Bithumb

Chart built with data obtained from /aggregated-orderbook endpoint

Historical aggregated orderbooks

GET https://api.coinact.gg/aggregated-orderbook

Retrieves a list of aggregated orderbooks for a given cryptocurrency and a given timeframe

Query Parameters

Name	Type	Description
symbol*	String	Get aggregated orderbooks for a specific cryptocurrency eg: BTC
timeframe*	String	The resolution at which you want to receive the orderbooks. valid timeframes : ["5m", "15m", "1h", "4h", "1d"] default: 5m
start	UNIX Timestamp (s)	Get aggregated orderbooks on a given period
end	UNIX Timestamp (s)	Get aggregated orderbooks on a given period
page	Integer	id of the page you want to query (default=1)
limit	Integer	Number of orderbooks to return (default:50; max: 50)

200: OK A list of aggregated orderbooks

priceUsd: This field represents the price of the order in United States Dollars (USD).

net_amount: This is a numeric value representing the absolute difference between the bids and asks for this particular level, aggregated across all exchanges. It essentially measures the net demand or supply at this price level. exchanges_breakdown: This is a more detailed breakdown of the net_amount for each individual exchange at the given price level. It is an array where each item consists of two parts:

exchangeId: A unique identifier for an exchange. You can use the /v1/exchanges endpoint to map this exchangeId to the actual name or label of the exchange.

net_amount: The part of the net_amount that is specific to this exchange.

[
    {
        "symbol": "BTC",
        "interval_start": "2024-01-30T09:10:00+00:00",
        "data": [{\"priceUsd\": 49996.17, \"net_amount\": -319.215, \"exchanges_breakdown\": [[2, -1.888], [32, -303.605], [512, -8.569], [1024, -1.832], [2048, -3.322]]}, {\"priceUsd\": 43499.8, \"net_amount\": -267.259, \"exchanges_breakdown\": [[1, -32.13], [2, -4.826], [4, -3.626], [16, -0.173], [32, -8.947], [128, -1.039], [512, -3.118], [1024, -4.308], [2048, -0.412], [4096, -208.678]]}, {\"priceUsd\": 43469.91, \"net_amount\": -257.93800000000005, \"exchanges_breakdown\": [[1, -7.745], [2, -3.626], [4, -2.995], [16, -4.666], [32, -4.952], [128, -2.001], [512, -9.735], [1024, -3.748], [2048, -2.327], [4096, -216.145]]}, {\"priceUsd\": 35000.0, \"net_amount\": 223.74, \"exchanges_breakdown\": [[32, 212.035], [2048, 11.705]]}, {\"priceUsd\": 49202.04, \"net_amount\": -200.034, \"exchanges_breakdown\": [[32, -200.033], [512, -0.001], [2048, -0.0]]}, {\"priceUsd\": 31999.0, \"net_amount\": 171.735, \"exchanges_breakdown\": [[32, 166.725], [128, 0.005], [2048, 5.005]]}, {\"priceUsd\": 54999.99, \"net_amount\": -154.689, \"exchanges_breakdown\": [[32, -153.714], [1024, -0.003], [2048, -0.972]]}, {\"priceUsd\": 38000.0, \"net_amount\": 137.808, \"exchanges_breakdown\": [[32, 127.72], [512, 1.036], [1024, 0.008], [2048, 9.045]]}, {\"priceUsd\": 53000.0, \"net_amount\": -121.274, \"exchanges_breakdown\": [[32, -120.574], [2048, -0.7]]}, {\"priceUsd\": 51000.0, \"net_amount\": -116.767, \"exchanges_breakdown\": [[2, -0.001], [32, -116.087], [512, -0.145], [2048, -0.535]]}, {\"priceUsd\": 43999.0, \"net_amount\": -116.461, \"exchanges_breakdown\": [[1, -0.653], [2, -13.667], [32, -59.068], [128, -2.96], [512, -37.718], [2048, -2.131], [4096, -0.264]]}, {\"priceUsd\": 32005.14, \"net_amount\": 105.465, \"exchanges_breakdown\": [[32, 105.461], [2048, 0.004]]}, {\"priceUsd\": 34368.9, \"net_amount\": 105.169, \"exchanges_breakdown\": [[32, 105.169]]}, {\"priceUsd\": 36000.0, \"net_amount\": 103.565, \"exchanges_breakdown\": [[32, 94.874], [512, 2.609], [1024, 0.026], [2048, 6.056]]}, {\"priceUsd\": 43396.23, \"net_amount\": 102.232, \"exchanges_breakdown\": [[1, 16.505], [2, 3.963], [4, 4.364], [16, 3.506], [32, 3.824], [128, 0.542], [512, 8.695], [1024, 3.031], [2048, 47.82], [4096, 9.983]]}, {\"priceUsd\": 43363.63, \"net_amount\": 100.263, \"exchanges_breakdown\": [[1, 7.413], [2, 1.207], [4, 3.145], [16, 6.478], [32, 16.547], [128, 2.06], [512, 38.229], [1024, 5.392], [2048, 12.544], [4096, 7.247]]}, {\"priceUsd\": 54554.0, \"net_amount\": -100.03, \"exchanges_breakdown\": [[32, -100.03]]}, {\"priceUsd\": 51210.32, \"net_amount\": -100.026, \"exchanges_breakdown\": [[32, -100.026]]}, {\"priceUsd\": 50303.0, \"net_amount\": -100.004, \"exchanges_breakdown\": [[32, -100.002], [2048, -0.002]]}, {\"priceUsd\": 43440.84, \"net_amount\": -97.005, \"exchanges_breakdown\": [[1, -27.491], [2, -5.551], [4, -17.982], [16, -8.012], [32, -12.768], [128, -2.291], [512, -6.558], [1024, -4.169], [2048, -0.0], [4096, -12.182]]}, {\"priceUsd\": 48998.0, \"net_amount\": -96.9, \"exchanges_breakdown\": [[2, -0.263], [32, -93.22], [512, -0.611], [1024, -0.011], [2048, -2.795]]}, {\"priceUsd\": 43375.67, \"net_amount\": 91.035, \"exchanges_breakdown\": [[1, 14.933], [2, 6.33], [4, 7.314], [16, 12.039], [32, 6.526], [128, 4.096], [512, 4.085], [1024, 2.544], [2048, 27.781], [4096, 5.387]]}, {\"priceUsd\": 43433.99, \"net_amount\": -88.439, \"exchanges_breakdown\": [[1, -19.75], [2, -2.495], [4, -27.947], [16, -8.876], [32, -2.512], [128, -1.51], [512, -12.1], [1024, -2.288], [4096, -10.962]]}, {\"priceUsd\": 43457.64, \"net_amount\": -83.53200000000001, \"exchanges_breakdown\": [[1, -22.539], [2, -1.645], [4, -19.754], [16, -8.48], [32, -11.314], [128, -0.785], [512, -7.581], [1024, -2.902], [4096, -8.533]]}, {\"priceUsd\": 43375.67, \"net_amount\": 81.393, \"exchanges_breakdown\": [[1, 10.823], [2, 9.094], [4, 12.132], [16, 15.6], [32, 8.592], [128, 5.512], [512, 1.959], [1024, 3.256], [2048, 0.04], [4096, 14.384]]}, {\"priceUsd\": 43433.99, \"net_amount\": -80.919, \"exchanges_breakdown\": [[1, -12.424], [2, -2.901], [4, -24.114], [16, -13.239], [32, -3.695], [128, -3.503], [512, -12.096], [1024, -2.146], [2048, -0.014], [4096, -6.788]]}, {\"priceUsd\": 43266.57, \"net_amount\": 79.436, \"exchanges_breakdown\": [[1, 51.505], [2, 0.746], [4, 0.947], [16, 0.006], [32, 0.989], [128, 0.017], [512, 22.509], [1024, 0.385], [2048, 2.333]]}, {\"priceUsd\": 33999.0, \"net_amount\": 76.281, \"exchanges_breakdown\": [[32, 72.753], [2048, 3.528]]}, {\"priceUsd\": 38496.87, \"net_amount\": 73.853, \"exchanges_breakdown\": [[1, 6.009], [2, 2.652], [32, 61.086], [512, 0.547], [2048, 3.559]]}, {\"priceUsd\": 43457.64, \"net_amount\": -73.783, \"exchanges_breakdown\": [[1, -15.938], [2, -5.484], [4, -8.699], [16, -7.424], [32, -6.359], [128, -2.234], [512, -6.161], [1024, -16.69], [2048, -0.012], [4096, -4.782]]}, {\"priceUsd\": 43387.97, \"net_amount\": 73.712, \"exchanges_breakdown\": [[1, 7.617], [2, 1.197], [4, 15.049], [16, 16.369], [32, 2.956], [128, 1.12], [512, 9.739], [1024, 13.184], [4096, 6.483]]}, {\"priceUsd\": 47999.0, \"net_amount\": -72.857, \"exchanges_breakdown\": [[1, -20.818], [2, -0.35], [32, -49.188], [128, -0.002], [512, -0.046], [1024, -0.008], [2048, -2.444]]}, {\"priceUsd\": 44197.47, \"net_amount\": -71.947, \"exchanges_breakdown\": [[1, -3.658], [2, -28.901], [32, -34.261], [512, -4.337], [1024, -0.0], [2048, -0.789]]}, {\"priceUsd\": 42561.0, \"net_amount\": 70.81, \"exchanges_breakdown\": [[1, 2.0], [2, 68.691], [32, 0.115], [512, 0.004]]}, {\"priceUsd\": 44173.0, \"net_amount\": -70.013, \"exchanges_breakdown\": [[1, -0.05], [2, -69.153], [32, -0.023], [512, -0.786], [2048, -0.0]]}, {\"priceUsd\": 44250.0, \"net_amount\": -69.226, \"exchanges_breakdown\": [[1, -0.007], [2, -69.011], [32, -0.088], [512, -0.118], [2048, -0.002]]}, {\"priceUsd\": 32999.0, \"net_amount\": 66.59, \"exchanges_breakdown\": [[32, 63.38], [2048, 3.209]]}, {\"priceUsd\": 43479.16, \"net_amount\": -65.473, \"exchanges_breakdown\": [[1, -6.276], [2, -4.795], [4, -3.408], [16, -2.047], [32, -9.399], [128, -1.618], [512, -27.883], [1024, -1.101], [2048, -2.052], [4096, -6.894]]}, {\"priceUsd\": 43469.91, \"net_amount\": -64.961, \"exchanges_breakdown\": [[1, -18.818], [2, -3.751], [4, -3.218], [16, -2.078], [32, -10.199], [128, -1.243], [512, -15.531], [1024, -0.658], [2048, -0.002], [4096, -9.462]]}, {\"priceUsd\": 43396.23, \"net_amount\": 64.865, \"exchanges_breakdown\": [[1, 14.23], [2, 4.319], [4, 16.816], [16, 7.403], [32, 5.418], [128, 2.128], [512, 9.654], [1024, 0.934], [4096, 3.963]]}, {\"priceUsd\": 43349.99, \"net_amount\": 64.094, \"exchanges_breakdown\": [[1, 18.378], [2, 9.943], [4, 3.402], [16, 6.136], [32, 8.741], [128, 1.114], [512, 7.786], [1024, 1.474], [4096, 7.119]]}, {\"priceUsd\": 46999.0, \"net_amount\": -63.884, \"exchanges_breakdown\": [[1, -0.053], [2, -0.111], [32, -62.922], [512, -0.041], [1024, -0.0], [2048, -0.758]]}, {\"priceUsd\": 37000.0, \"net_amount\": 61.122, \"exchanges_breakdown\": [[32, 54.245], [128, 0.015], [512, 1.334], [2048, 5.528]]}, {\"priceUsd\": 34500.0, \"net_amount\": 60.665, \"exchanges_breakdown\": [[32, 59.354], [2048, 1.312]]}, {\"priceUsd\": 37500.0, \"net_amount\": 60.311, \"exchanges_breakdown\": [[32, 54.109], [128, 0.003], [512, 3.217], [1024, 0.001], [2048, 2.98]]}, {\"priceUsd\": 44997.27, \"net_amount\": -58.764, \"exchanges_breakdown\": [[1, -0.105], [2, -8.587], [32, -47.833], [128, -0.002], [512, -0.022], [1024, -0.01], [2048, -2.205]]}, {\"priceUsd\": 44222.0, \"net_amount\": -58.673, \"exchanges_breakdown\": [[1, -0.013], [2, -57.367], [32, -0.059], [512, -1.234]]}, {\"priceUsd\": 42580.05, \"net_amount\": 57.47, \"exchanges_breakdown\": [[1, 0.001], [2, 57.22], [32, 0.034], [512, 0.214]]}, {\"priceUsd\": 48807.57, \"net_amount\": -56.243, \"exchanges_breakdown\": [[2, -5.669], [32, -50.559], [512, -0.003], [2048, -0.013]]}, {\"priceUsd\": 43885.88, \"net_amount\": -52.392, \"exchanges_breakdown\": [[1, 0.037], [2, -0.05], [32, -0.128], [128, -10.393], [512, -41.815], [2048, -0.044], [4096, -0.0]]}, {\"priceUsd\": 30999.0, \"net_amount\": 52.051, \"exchanges_breakdown\": [[32, 51.01], [1024, 0.001], [2048, 1.04]]}, {\"priceUsd\": 43515.0, \"net_amount\": -51.705, \"exchanges_breakdown\": [[1, -5.655], [2, -9.222], [4, -3.313], [16, -0.013], [32, -4.527], [128, -0.025], [512, -22.602], [1024, -0.0], [2048, -2.518], [4096, -3.83]]}, {\"priceUsd\": 38999.0, \"net_amount\": 49.951, \"exchanges_breakdown\": [[1, 10.768], [2, 0.651], [32, 36.412], [512, 0.196], [1024, 0.221], [2048, 1.703]]}, {\"priceUsd\": 51999.99, \"net_amount\": -48.631, \"exchanges_breakdown\": [[32, -45.645], [512, -0.97], [1024, -1.024], [2048, -0.992]]}, {\"priceUsd\": 43316.47, \"net_amount\": 48.598, \"exchanges_breakdown\": [[1, 0.663], [2, 12.182], [4, 3.297], [16, 3.051], [32, 11.359], [128, 2.371], [512, 5.345], [1024, 4.337], [2048, 2.362], [4096, 3.631]]}, {\"priceUsd\": 43349.99, \"net_amount\": 48.339, \"exchanges_breakdown\": [[1, 8.791], [2, 0.732], [4, 3.05], [16, 2.498], [32, 4.735], [128, 2.373], [512, 20.49], [1024, 0.606], [4096, 5.064]]}, {\"priceUsd\": 42600.0, \"net_amount\": 48.309, \"exchanges_breakdown\": [[1, 0.001], [2, 46.81], [32, 0.915], [512, 0.526], [2048, 0.057]]}, {\"priceUsd\": 44695.62, \"net_amount\": -47.731, \"exchanges_breakdown\": [[1, -0.001], [2, -0.16], [32, -46.03], [128, -0.029], [512, -1.506], [2048, -0.005]]}, {\"priceUsd\": 44214.07, \"net_amount\": -46.429, \"exchanges_breakdown\": [[1, -0.039], [2, -45.921], [32, -0.062], [128, -0.007], [512, -0.392], [2048, -0.008]]}, {\"priceUsd\": 35500.0, \"net_amount\": 43.565, \"exchanges_breakdown\": [[32, 40.429], [512, 2.477], [2048, 0.659]]}, {\"priceUsd\": 48498.36, \"net_amount\": -42.997, \"exchanges_breakdown\": [[1, -0.526], [2, -0.004], [32, -41.716], [512, -0.001], [2048, -0.749]]}, {\"priceUsd\": 44385.71, \"net_amount\": -41.753, \"exchanges_breakdown\": [[1, -0.078], [2, -0.003], [32, -41.571], [2048, -0.1]]}, {\"priceUsd\": 43646.15, \"net_amount\": -40.381, \"exchanges_breakdown\": [[1, 0.083], [2, -2.365], [32, -36.563], [128, -0.045], [512, -0.021], [4096, -1.47]]}, {\"priceUsd\": 44500.0, \"net_amount\": -38.782, \"exchanges_breakdown\": [[1, -17.708], [2, -0.687], [32, -14.505], [512, -5.564], [2048, -0.319]]}, {\"priceUsd\": 43873.32, \"net_amount\": 38.368, \"exchanges_breakdown\": [[1, 0.047], [2, -1.619], [32, -0.149], [128, -0.098], [512, -0.121], [2048, 40.308], [4096, -0.0]]}, {\"priceUsd\": 32499.99, \"net_amount\": 38.254, \"exchanges_breakdown\": [[32, 37.524], [1024, 0.044], [2048, 0.686]]}, {\"priceUsd\": 43180.0, \"net_amount\": 38.205, \"exchanges_breakdown\": [[1, 0.544], [2, 20.585], [32, 7.822], [128, 9.021], [512, 0.229], [1024, 0.001], [4096, 0.003]]}, {\"priceUsd\": 43266.57, \"net_amount\": 38.087, \"exchanges_breakdown\": [[1, 0.039], [2, 11.959], [4, 1.363], [16, 1.427], [32, 11.207], [128, 0.089], [512, 12.002], [1024, 0.0], [2048, 0.001], [4096, 0.0]]}, {\"priceUsd\": 49500.0, \"net_amount\": -37.894, \"exchanges_breakdown\": [[2, -0.597], [32, -36.705], [512, -0.003], [2048, -0.59]]}, {\"priceUsd\": 44150.0, \"net_amount\": -37.809, \"exchanges_breakdown\": [[1, -1.961], [2, -0.034], [32, -35.099], [512, -0.142], [2048, -0.573]]}, {\"priceUsd\": 31500.0, \"net_amount\": 37.716, \"exchanges_breakdown\": [[32, 37.354], [2048, 0.363]]}, {\"priceUsd\": 43363.63, \"net_amount\": 36.117, \"exchanges_breakdown\": [[1, 8.974], [2, 1.275], [4, 3.105], [16, 6.308], [32, 2.563], [128, 0.376], [512, 2.144], [1024, 0.238], [4096, 11.133]]}, {\"priceUsd\": 36500.0, \"net_amount\": 35.839, \"exchanges_breakdown\": [[32, 33.581], [512, 0.697], [2048, 1.561]]}, {\"priceUsd\": 44188.06, \"net_amount\": -35.801, \"exchanges_breakdown\": [[1, -0.007], [2, -34.42], [32, -0.794], [512, -0.58]]}, {\"priceUsd\": 42622.66, \"net_amount\": 35.228, \"exchanges_breakdown\": [[1, 0.001], [2, 35.152], [32, 0.014], [512, 0.062]]}, {\"priceUsd\": 42500.0, \"net_amount\": 35.055, \"exchanges_breakdown\": [[1, 0.626], [2, 21.869], [32, 10.3], [512, 2.119], [2048, 0.141]]}, {\"priceUsd\": 43331.59, \"net_amount\": 34.545, \"exchanges_breakdown\": [[1, 4.158], [2, 4.383], [4, 3.289], [16, 1.029], [32, 3.188], [128, 1.392], [512, 5.98], [2048, 2.289], [4096, 8.837]]}, {\"priceUsd\": 43552.94, \"net_amount\": -33.847, \"exchanges_breakdown\": [[1, -4.266], [2, -0.511], [4, -1.148], [32, -14.333], [128, -0.03], [512, -8.804], [1024, -0.0], [2048, -2.339], [4096, -2.417]]}, {\"priceUsd\": 43486.33, \"net_amount\": -33.003, \"exchanges_breakdown\": [[1, -10.12], [2, -1.818], [4, -3.255], [16, -0.002], [32, -5.27], [128, -0.075], [512, -3.721], [1024, -1.15], [2048, -0.001], [4096, -7.591]]}, {\"priceUsd\": 43331.59, \"net_amount\": 32.43, \"exchanges_breakdown\": [[1, 0.731], [2, 1.437], [4, 3.494], [16, 3.198], [32, 13.015], [128, 0.281], [512, 7.712], [2048, 0.001], [4096, 2.561]]}, {\"priceUsd\": 42666.6, \"net_amount\": 31.327, \"exchanges_breakdown\": [[2, 28.641], [32, 2.507], [512, 0.178], [2048, 0.001]]}, {\"priceUsd\": 43297.0, \"net_amount\": 31.246, \"exchanges_breakdown\": [[1, 8.37], [2, 1.198], [4, 1.155], [16, 0.578], [32, 8.286], [128, 0.006], [512, 9.583], [1024, 0.101], [2048, 1.327], [4096, 0.643]]}, {\"priceUsd\": 32200.0, \"net_amount\": 30.448, \"exchanges_breakdown\": [[32, 30.423], [2048, 0.025]]}, {\"priceUsd\": 43306.23, \"net_amount\": 30.377, \"exchanges_breakdown\": [[1, 8.461], [2, 7.106], [4, 3.238], [16, 1.062], [32, 3.768], [128, 0.0], [512, 6.04], [4096, 0.702]]}, {\"priceUsd\": 34251.0, \"net_amount\": 29.608, \"exchanges_breakdown\": [[32, 29.608]]}, {\"priceUsd\": 38705.16, \"net_amount\": 29.365, \"exchanges_breakdown\": [[1, 0.003], [2, 0.067], [32, 0.429], [2048, 28.866]]}, {\"priceUsd\": 42528.0, \"net_amount\": 29.048, \"exchanges_breakdown\": [[1, 6.0], [2, 0.221], [32, 0.054], [512, 22.772]]}, {\"priceUsd\": 43986.38, \"net_amount\": -28.831, \"exchanges_breakdown\": [[1, -0.098], [2, -0.212], [32, -27.947], [128, -0.134], [512, -0.145], [2048, -0.19], [4096, -0.104]]}, {\"priceUsd\": 43196.0, \"net_amount\": 28.365, \"exchanges_breakdown\": [[1, 0.84], [2, 0.541], [32, 23.45], [128, 0.001], [512, 3.429], [1024, 0.0], [4096, 0.104]]}, {\"priceUsd\": 33330.0, \"net_amount\": 28.336, \"exchanges_breakdown\": [[32, 26.687], [2048, 1.649]]}, {\"priceUsd\": 43929.0, \"net_amount\": -28.275, \"exchanges_breakdown\": [[1, -0.035], [2, -0.068], [32, -21.126], [128, -5.891], [512, -1.151], [2048, -0.003], [4096, -0.0]]}, {\"priceUsd\": 39497.34, \"net_amount\": 28.064, \"exchanges_breakdown\": [[1, 0.047], [2, 0.608], [32, 26.079], [2048, 1.331]]}, {\"priceUsd\": 43479.16, \"net_amount\": -27.869, \"exchanges_breakdown\": [[1, -5.124], [2, -1.742], [4, -3.06], [16, -1.783], [32, -4.349], [128, -0.73], [512, -2.109], [1024, -0.001], [2048, -0.001], [4096, -8.97]]}, {\"priceUsd\": 43419.6, \"net_amount\": 27.840000000000003, \"exchanges_breakdown\": [[1, 17.082], [2, 5.454], [16, -10.487], [32, -1.229], [128, -0.847], [512, 4.942], [1024, 5.536], [2048, -0.001], [4096, 7.389]]}, {\"priceUsd\": 35300.0, \"net_amount\": 27.752, \"exchanges_breakdown\": [[32, 27.076], [512, 0.653], [2048, 0.023]]}, {\"priceUsd\": 43915.23, \"net_amount\": -27.718, \"exchanges_breakdown\": [[1, 0.572], [2, -0.032], [32, -0.175], [128, -0.007], [512, -0.573], [2048, -27.5], [4096, -0.003]]}, {\"priceUsd\": 43525.94, \"net_amount\": -27.324, \"exchanges_breakdown\": [[1, -1.331], [2, -16.88], [4, -3.436], [16, -1.403], [32, -1.765], [128, -1.052], [512, -1.048], [1024, -0.385], [2048, -0.024], [4096, -0.0]]}, {\"priceUsd\": 50049.52, \"net_amount\": -27.32, \"exchanges_breakdown\": [[32, -27.317], [2048, -0.003]]}, {\"priceUsd\": 43342.3, \"net_amount\": 27.28, \"exchanges_breakdown\": [[1, 4.612], [2, 0.777], [4, 3.513], [16, 2.433], [32, 5.656], [128, 0.503], [512, 4.736], [1024, 1.605], [4096, 3.444]]}, {\"priceUsd\": 43214.21, \"net_amount\": 27.216, \"exchanges_breakdown\": [[1, 0.598], [2, 0.397], [4, 0.002], [16, 0.032], [32, 18.669], [128, 0.003], [512, 0.277], [1024, 7.236], [4096, 0.002]]}, {\"priceUsd\": 38100.0, \"net_amount\": 26.728, \"exchanges_breakdown\": [[32, 22.77], [512, 0.165], [2048, 3.793]]}, {\"priceUsd\": 43747.0, \"net_amount\": -26.703, \"exchanges_breakdown\": [[1, 0.062], [2, -0.044], [32, -25.61], [128, -0.058], [512, -1.052], [2048, -0.0], [4096, -0.001]]}, {\"priceUsd\": 51087.81, \"net_amount\": -25.959, \"exchanges_breakdown\": [[32, -0.335], [2048, -25.624]]}, {\"priceUsd\": 39998.43, \"net_amount\": 25.633, \"exchanges_breakdown\": [[1, 0.476], [2, 0.264], [32, 22.337], [512, 0.032], [2048, 2.525]]}, {\"priceUsd\": 43625.49, \"net_amount\": -25.562, \"exchanges_breakdown\": [[1, 0.011], [2, -10.329], [32, -0.109], [128, -10.941], [512, -3.425], [1024, -0.764], [4096, -0.005]]}, {\"priceUsd\": 52100.0, \"net_amount\": -25.406, \"exchanges_breakdown\": [[32, -25.353], [2048, -0.053]]}, {\"priceUsd\": 34554.33, \"net_amount\": 24.919, \"exchanges_breakdown\": [[32, 24.919]]}, {\"priceUsd\": 42720.0, \"net_amount\": 24.68, \"exchanges_breakdown\": [[1, 0.005], [2, 23.18], [32, 0.013], [512, 1.482]]}, {\"priceUsd\": 44900.0, \"net_amount\": -23.832, \"exchanges_breakdown\": [[1, -0.001], [2, -0.212], [32, -21.302], [512, -0.103], [2048, -2.214]]}, {\"priceUsd\": 35012.78, \"net_amount\": 23.76, \"exchanges_breakdown\": [[32, 23.403], [2048, 0.357]]}, {\"priceUsd\": 44132.5, \"net_amount\": -23.267, \"exchanges_breakdown\": [[1, -0.131], [2, -22.985], [32, -0.13], [128, -0.006], [512, -0.014]]}, {\"priceUsd\": 35097.35, \"net_amount\": 23.122, \"exchanges_breakdown\": [[32, 21.851], [2048, 1.271]]}, {\"priceUsd\": 44095.91, \"net_amount\": -22.787, \"exchanges_breakdown\": [[1, -6.603], [2, -0.221], [32, -13.804], [512, -2.044], [2048, -0.115]]}, {\"priceUsd\": 46000.0, \"net_amount\": -22.626, \"exchanges_breakdown\": [[1, -0.219], [2, -0.753], [32, -19.024], [512, -0.111], [2048, -2.519]]}, {\"priceUsd\": 43579.9, \"net_amount\": -22.477, \"exchanges_breakdown\": [[1, -2.979], [2, -0.086], [4, -1.079], [32, -12.414], [128, -0.076], [512, -5.87], [1024, 0.028], [4096, -0.001]]}, {\"priceUsd\": 43499.8, \"net_amount\": -22.214, \"exchanges_breakdown\": [[1, -2.841], [2, -0.026], [4, -3.115], [16, -0.043], [32, -0.483], [128, -2.125], [512, -9.152], [1024, -0.0], [2048, -0.0], [4096, -4.428]]}, {\"priceUsd\": 44944.0, \"net_amount\": -21.989, \"exchanges_breakdown\": [[1, -0.269], [32, -21.665], [2048, -0.056]]}, {\"priceUsd\": 43419.6, \"net_amount\": 21.546999999999997, \"exchanges_breakdown\": [[1, 14.37], [2, 3.204], [4, 14.078], [16, -10.482], [32, -5.443], [128, -1.423], [512, -0.15], [1024, 2.294], [4096, 5.099]]}, {\"priceUsd\": 44443.0, \"net_amount\": -20.127, \"exchanges_breakdown\": [[1, -0.541], [2, -0.83], [32, -18.485], [512, -0.165], [2048, -0.106]]}, {\"priceUsd\": 43525.94, \"net_amount\": -20.014, \"exchanges_breakdown\": [[1, -0.131], [2, -6.524], [4, -1.179], [16, -0.011], [32, -11.163], [128, -0.039], [512, -0.007], [1024, -0.0], [2048, -0.002], [4096, -0.957]]}, {\"priceUsd\": 43562.88, \"net_amount\": -19.966, \"exchanges_breakdown\": [[1, -0.3], [2, -1.035], [4, -1.117], [32, -0.222], [128, -0.004], [512, -17.285], [1024, -0.0], [4096, -0.003]]}, {\"priceUsd\": 44044.82, \"net_amount\": -19.965, \"exchanges_breakdown\": [[1, -0.287], [2, -17.314], [32, -0.142], [128, -0.222], [512, -1.9], [2048, -0.1], [4096, -0.0]]}, {\"priceUsd\": 43276.0, \"net_amount\": 19.564, \"exchanges_breakdown\": [[1, 0.664], [2, 0.129], [4, 1.003], [16, 0.005], [32, 4.047], [128, 4.402], [512, 8.114], [1024, 0.101], [4096, 1.1]]}, {\"priceUsd\": 30500.0, \"net_amount\": 19.544, \"exchanges_breakdown\": [[32, 18.595], [2048, 0.949]]}, {\"priceUsd\": 43283.82, \"net_amount\": 19.021, \"exchanges_breakdown\": [[1, 0.288], [2, 1.217], [4, 1.368], [16, 0.018], [32, 6.492], [128, 0.087], [512, 9.073], [4096, 0.478]]}, {\"priceUsd\": 43544.4, \"net_amount\": -18.947, \"exchanges_breakdown\": [[1, -0.85], [2, -0.203], [4, -1.016], [32, -0.1], [128, -0.053], [512, -15.429], [1024, -1.293], [2048, -0.001], [4096, -0.003]]}, {\"priceUsd\": 49772.07, \"net_amount\": -18.92, \"exchanges_breakdown\": [[32, -18.82], [2048, -0.1]]}, {\"priceUsd\": 42810.0, \"net_amount\": 18.84, \"exchanges_breakdown\": [[2, 17.166], [32, 0.055], [128, 0.068], [512, 1.552], [4096, 0.0]]}, {\"priceUsd\": 43257.22, \"net_amount\": 18.57, \"exchanges_breakdown\": [[1, 0.699], [2, 0.68], [4, 0.524], [16, 0.002], [32, 12.482], [128, 2.589], [512, 1.591], [4096, 0.003]]}, {\"priceUsd\": 32450.0, \"net_amount\": 18.552, \"exchanges_breakdown\": [[32, 18.552]]}, {\"priceUsd\": 33498.27, \"net_amount\": 18.434, \"exchanges_breakdown\": [[32, 17.366], [2048, 1.068]]}, {\"priceUsd\": 43125.0, \"net_amount\": 18.403, \"exchanges_breakdown\": [[1, 0.0], [2, 0.0], [32, 0.045], [128, 0.033], [512, 18.325], [4096, 0.0]]}, {\"priceUsd\": 43798.32, \"net_amount\": -18.054000000000002, \"exchanges_breakdown\": [[1, 0.041], [2, -10.06], [32, -0.063], [128, -7.917], [512, -0.047], [2048, -0.006], [4096, -0.002]]}, {\"priceUsd\": 39395.68, \"net_amount\": 17.997, \"exchanges_breakdown\": [[1, 0.051], [2, 0.001], [32, 17.936], [2048, 0.01]]}, {\"priceUsd\": 43899.0, \"net_amount\": -17.884, \"exchanges_breakdown\": [[1, -5.324], [2, -1.404], [32, -3.696], [128, -2.633], [512, -3.512], [2048, -0.907], [4096, -0.006], [8192, -0.402]]}, {\"priceUsd\": 43579.9, \"net_amount\": -17.882, \"exchanges_breakdown\": [[1, -0.284], [2, -7.729], [4, -1.4], [32, -3.948], [128, -4.445], [512, -0.073], [1024, -0.0], [4096, -0.003]]}, {\"priceUsd\": 43625.49, \"net_amount\": -17.842, \"exchanges_breakdown\": [[1, -0.06], [2, -1.355], [32, -1.089], [128, -0.037], [512, -7.279], [1024, -8.022], [4096, -0.0]]}, {\"priceUsd\": 43686.6, \"net_amount\": -17.763, \"exchanges_breakdown\": [[1, 0.12], [2, -10.289], [32, -6.73], [128, -0.038], [512, -0.825], [2048, -0.0], [4096, -0.0]]}, {\"priceUsd\": 43257.22, \"net_amount\": 17.723, \"exchanges_breakdown\": [[1, 0.496], [2, 0.5], [4, 1.28], [16, 0.003], [32, 12.865], [128, 0.016], [512, 0.049], [1024, 0.101], [4096, 2.413]]}, {\"priceUsd\": 41999.95, \"net_amount\": 17.563, \"exchanges_breakdown\": [[1, 0.219], [2, 1.378], [32, 14.474], [512, 0.399], [2048, 1.093]]}, {\"priceUsd\": 54000.0, \"net_amount\": -17.391, \"exchanges_breakdown\": [[32, -17.314], [2048, -0.077]]}, {\"priceUsd\": 43654.6, \"net_amount\": -17.263, \"exchanges_breakdown\": [[1, 1.062], [2, -5.954], [32, -2.188], [128, -2.587], [512, -7.593], [2048, -0.001], [4096, -0.003]]}, {\"priceUsd\": 55997.0, \"net_amount\": -16.921, \"exchanges_breakdown\": [[32, -16.317], [1024, -0.0], [2048, -0.604]]}, {\"priceUsd\": 43316.47, \"net_amount\": 16.863, \"exchanges_breakdown\": [[1, 3.441], [2, 0.865], [4, 2.951], [16, 1.41], [32, 0.623], [128, 1.146], [512, 3.203], [1024, 0.217], [4096, 3.007]]}, {\"priceUsd\": 43134.28, \"net_amount\": 16.72, \"exchanges_breakdown\": [[1, 0.001], [2, 5.408], [32, 0.254], [128, 10.949], [512, 0.099], [1024, 0.0], [2048, 0.001], [4096, 0.009]]}, {\"priceUsd\": 43000.0, \"net_amount\": 16.379, \"exchanges_breakdown\": [[2, 16.337], [32, 0.018], [128, 0.008], [512, 0.011], [2048, 0.003], [4096, 0.001]]}, {\"priceUsd\": 36095.01, \"net_amount\": 16.137, \"exchanges_breakdown\": [[32, 14.591], [512, 0.043], [2048, 1.503]]}, {\"priceUsd\": 37800.0, \"net_amount\": 15.975, \"exchanges_breakdown\": [[32, 15.786], [512, 0.025], [2048, 0.164]]}, {\"priceUsd\": 43654.6, \"net_amount\": -15.700000000000001, \"exchanges_breakdown\": [[1, 0.339], [2, -1.648], [32, -14.208], [128, -0.001], [512, -0.008], [2048, -0.165], [4096, -0.009]]}, {\"priceUsd\": 43603.77, \"net_amount\": -15.689, \"exchanges_breakdown\": [[1, 0.025], [2, -0.004], [32, -0.0], [128, -0.004], [512, -15.703], [1024, -0.0], [4096, -0.002]]}, {\"priceUsd\": 38600.0, \"net_amount\": 15.621, \"exchanges_breakdown\": [[1, 1.71], [2, 0.053], [32, 12.337], [512, 0.014], [2048, 1.508]]}, {\"priceUsd\": 42298.0, \"net_amount\": 15.533, \"exchanges_breakdown\": [[2, 0.305], [32, 14.917], [512, 0.056], [2048, 0.255]]}, {\"priceUsd\": 54575.0, \"net_amount\": -15.4, \"exchanges_breakdown\": [[32, -15.4]]}, {\"priceUsd\": 43515.0, \"net_amount\": -15.391, \"exchanges_breakdown\": [[1, -2.642], [2, -5.037], [4, -3.273], [16, -0.004], [32, -3.867], [128, -0.012], [512, -0.534], [1024, -0.0], [2048, -0.001], [4096, -0.02]]}, {\"priceUsd\": 43784.49, \"net_amount\": -15.345, \"exchanges_breakdown\": [[1, 0.007], [2, -0.026], [32, -0.279], [128, -0.089], [512, -14.854], [2048, -0.001], [4096, -0.104]]}, {\"priceUsd\": 34010.0, \"net_amount\": 15.312, \"exchanges_breakdown\": [[32, 15.311], [2048, 0.001]]}, {\"priceUsd\": 55575.29, \"net_amount\": -15.005, \"exchanges_breakdown\": [[32, -15.005]]}, {\"priceUsd\": 53573.0, \"net_amount\": -15.0, \"exchanges_breakdown\": [[32, -15.0]]}, {\"priceUsd\": 48900.0, \"net_amount\": -14.959, \"exchanges_breakdown\": [[2, -0.206], [32, -13.751], [512, -0.5], [2048, -0.502]]}, {\"priceUsd\": 43952.4, \"net_amount\": -14.909, \"exchanges_breakdown\": [[1, -0.864], [2, -11.518], [32, -0.229], [128, -0.011], [512, -0.01], [1024, -0.0], [2048, -0.002], [4096, -2.275]]}, {\"priceUsd\": 43603.77, \"net_amount\": -14.84, \"exchanges_breakdown\": [[1, -0.123], [2, -2.142], [32, -0.106], [128, -0.041], [512, -12.425], [1024, -0.0], [2048, -0.002], [4096, -0.0]]}, {\"priceUsd\": 43230.4, \"net_amount\": 14.833, \"exchanges_breakdown\": [[1, 14.712], [2, 0.009], [4, 0.0], [16, 0.007], [32, 0.0], [128, 0.016], [512, 0.088], [4096, 0.0]]}, {\"priceUsd\": 36200.0, \"net_amount\": 14.633, \"exchanges_breakdown\": [[32, 13.689], [512, 0.293], [2048, 0.651]]}, {\"priceUsd\": 43153.49, \"net_amount\": 14.361, \"exchanges_breakdown\": [[1, 0.0], [2, 0.006], [32, 14.174], [128, 0.016], [512, 0.157], [1024, 0.0], [2048, 0.0], [4096, 0.007]]}, {\"priceUsd\": 42966.0, \"net_amount\": 14.356, \"exchanges_breakdown\": [[2, 7.962], [32, 0.123], [128, 6.122], [512, 0.002], [1024, 0.147], [4096, 0.0]]}, {\"priceUsd\": 43427.62, \"net_amount\": -14.263999999999996, \"exchanges_breakdown\": [[1, 5.495], [2, -0.158], [4, 22.465], [16, -22.406], [32, -3.056], [128, -4.597], [512, -8.65], [1024, 0.234], [4096, -3.591]]}, {\"priceUsd\": 43246.64, \"net_amount\": 14.191, \"exchanges_breakdown\": [[1, 1.796], [2, 1.638], [4, 0.0], [16, 0.019], [32, 6.868], [128, 0.019], [512, 0.057], [1024, 1.293], [2048, 2.501]]}, {\"priceUsd\": 44013.2, \"net_amount\": -13.877, \"exchanges_breakdown\": [[1, -1.51], [2, -0.022], [32, -4.85], [128, -5.998], [512, -1.247], [2048, -0.25], [4096, -0.0]]}, {\"priceUsd\": 42100.84, \"net_amount\": 13.752, \"exchanges_breakdown\": [[1, 0.0], [2, 10.535], [32, 2.907], [512, 0.292], [2048, 0.018]]}, {\"priceUsd\": 51500.0, \"net_amount\": -13.565, \"exchanges_breakdown\": [[32, -12.781], [512, -0.5], [2048, -0.284]]}, {\"priceUsd\": 49400.0, \"net_amount\": -13.514, \"exchanges_breakdown\": [[2, -0.13], [32, -13.191], [1024, -0.018], [2048, -0.176]]}, {\"priceUsd\": 43571.42, \"net_amount\": -13.244, \"exchanges_breakdown\": [[1, -0.29], [2, -10.544], [4, -1.129], [32, -0.706], [128, -0.002], [512, -0.522], [1024, -0.0], [2048, -0.028], [4096, -0.023]]}, {\"priceUsd\": 43173.07, \"net_amount\": 13.182, \"exchanges_breakdown\": [[1, 0.0], [2, 1.017], [32, 0.249], [128, 0.003], [512, 11.908], [1024, 0.001], [4096, 0.003]]}, {\"priceUsd\": 42666.6, \"net_amount\": 13.138, \"exchanges_breakdown\": [[1, 0.0], [2, 9.927], [32, 0.01], [512, 3.201]]}, {\"priceUsd\": 43283.82, \"net_amount\": 13.131, \"exchanges_breakdown\": [[1, 0.363], [2, 0.491], [4, 1.154], [16, 0.321], [32, 0.485], [128, 0.021], [512, 7.156], [1024, 0.385], [2048, 2.32], [4096, 0.434]]}, {\"priceUsd\": 43706.96, \"net_amount\": -13.108, \"exchanges_breakdown\": [[1, -0.218], [2, -1.984], [32, -0.195], [128, -10.647], [512, -0.057], [2048, -0.001], [4096, -0.006]]}, {\"priceUsd\": 38015.0, \"net_amount\": 13.074, \"exchanges_breakdown\": [[32, 11.451], [512, 0.024], [2048, 1.599]]}, {\"priceUsd\": 41000.0, \"net_amount\": 12.933, \"exchanges_breakdown\": [[1, 0.141], [2, 0.225], [32, 11.058], [512, 0.407], [2048, 1.101]]}, {\"priceUsd\": 50102.28, \"net_amount\": -12.888, \"exchanges_breakdown\": [[32, -12.878], [2048, -0.01]]}, {\"priceUsd\": 45500.0, \"net_amount\": -12.881, \"exchanges_breakdown\": [[1, -0.024], [32, -6.658], [512, -0.343], [2048, -5.856]]}, {\"priceUsd\": 37011.41, \"net_amount\": 12.804, \"exchanges_breakdown\": [[32, 12.802], [2048, 0.003]]}, {\"priceUsd\": 43825.49, \"net_amount\": -12.686, \"exchanges_breakdown\": [[1, 0.085], [2, -0.03], [32, -0.305], [128, -0.021], [512, -12.412], [4096, -0.004]]}, {\"priceUsd\": 37895.0, \"net_amount\": 12.521, \"exchanges_breakdown\": [[32, 11.926], [512, 0.227], [2048, 0.368]]}, {\"priceUsd\": 51900.0, \"net_amount\": -12.478, \"exchanges_breakdown\": [[32, -11.364], [512, -1.046], [2048, -0.068]]}, {\"priceUsd\": 43756.25, \"net_amount\": -12.389, \"exchanges_breakdown\": [[1, 0.018], [2, -0.022], [32, -6.832], [128, -0.023], [512, -5.528], [4096, -0.003]]}, {\"priceUsd\": 42952.65, \"net_amount\": 12.316, \"exchanges_breakdown\": [[1, 0.002], [2, 0.0], [32, 0.03], [128, 0.008], [512, 12.274], [4096, 0.003]]}, {\"priceUsd\": 43552.94, \"net_amount\": -11.997, \"exchanges_breakdown\": [[1, -0.353], [2, -0.9], [4, -1.085], [32, -7.379], [128, -0.796], [512, -1.482], [1024, -0.0], [2048, -0.002], [4096, -0.0]]}, {\"priceUsd\": 42901.25, \"net_amount\": 11.97, \"exchanges_breakdown\": [[1, 0.0], [2, 11.858], [32, 0.055], [128, 0.043], [512, 0.014], [4096, 0.0]]}, {\"priceUsd\": 42989.0, \"net_amount\": 11.888, \"exchanges_breakdown\": [[2, 0.411], [32, 0.743], [128, 0.065], [512, 10.664], [2048, 0.0], [4096, 0.005]]}]
    }
]

400: Bad Request An error indicating why the request is invalid

{
    "error": [
        {
            "loc": [
                "symbol"
            ],
            "msg": "Invalid symbol format",
            "type": "value_error"
        }
    ]
}

Usage Example:

Request a snapshot of the aggregated BTC orderbook at 5-minute intervals over a specified period.

import json
import requests
from urllib.parse import urljoin

COINACT_API_URL = "https://api.coinact.gg/v1/"
ENDPOINT = "aggregated-orderbook"
HEADERS = {"x-api-key": "YOUR API KEY"}

def get_orderbooks(session, start, end, page):
    params = {
        'symbol': 'BTC',
        'timeframe': '5m',
        'start': start,
        'end': end,
        'page': page
    }
    response = session.get(urljoin(COINACT_API_URL, ENDPOINT), headers=HEADERS, params=params)
    return json.loads(response.content)

def fetch_all_orderbooks(start, end):
    liquidations = []
    page = 1
    with requests.Session() as session:
        while True:
            results = get_orderbooks(session, start, end, page)
            if not results:
                break
            liquidations.extend(results)
            page += 1
    return liquidations

if __name__ == "__main__":
    start_timestamp = '1704123127'
    end_timestamp = '1705347127'
    all_orderbooks = fetch_all_orderbooks(start_timestamp, end_timestamp)
    print(all_orderbooks)
    print(len(all_orderbooks))