Aperiodic
DataAlpha
CatalogOrder FlowL1 & L2Derivatives & Market Data
Get Started

Data Catalog

Browse our curated market data catalog across exchanges and asset types.

19 datasets

Trades

Derivatives

Market Data

L1 (Top of Book)

L2 (Order Book)

Preview Data

No subscription required

The following datasets are available to any authenticated user — even without a paid plan. Pass preview=True in the Python client, or call /api/v1/data/preview/:metric_id directly.

DatasetExchangeSymbolIntervalTimestampDate range
Candlesticksbinance-futuresperpetual-BTC-USDT:USDT5mexchange2025-05-01 — 2025-05-31
L2 Order Book Imbalancebinance-futuresperpetual-BTC-USDT:USDT5mexchange2025-05-01 — 2025-05-31
L1 Liquidity

L1 Liquidity

Spread (absolute and bps), depth, dollar depth — instantaneous and interval-averaged.

CodeAPI DocsTry It

spread_bps

Spread (bps)

Spread in basis points measures the instantaneous cost of crossing from the best bid to the best ask on a normalized scale.

It is one of the most direct and actionable summaries of top-of-book trading conditions.

spread_depth_ratio

Spread/Depth Ratio

Spread/Depth Ratio combines price width and displayed size into a single liquidity efficiency measure.

A market with tight spreads but little size can still be fragile, and this ratio helps expose that weakness.

total_dollar_depth

Total Dollar Depth

Total Dollar Depth aggregates the top-level bid and ask liquidity in value terms.

This gives a more practical view of executable size than raw units, especially across instruments with different prices.

dollar_depth_bid_avg

Avg Bid Dollar Depth

Average Bid Dollar Depth tracks the mean value resting on the bid at the top of book throughout the interval.

It helps answer whether supportive displayed buying liquidity was consistently present or only flashed briefly.

dollar_depth_ask_avg

Avg Ask Dollar Depth

Average Ask Dollar Depth provides the matching view for displayed sell-side liquidity at the best offer.

Comparing it with the bid average helps reveal whether one side of the book was structurally thinner or thicker during the bar.

Endpoint

/api/v1/data/l1_liquidity

Category

L1 (Top of Book)

Intervals
1m5m15m30m1h4h1d
Requires Prime
1s

Requires timestamp=true

Exchanges
binance-futuresokx-perpshyperliquid-perps
Fields14
spreadSpreadLast best ask price minus best bid price in the interval
spread_bpsSpread (bps)Last bid-ask spread in basis points of the midprice
spread_depth_ratioSpread/Depth RatioLast bid-ask spread divided by total top-of-book quantity
total_depthTotal DepthLast total top-of-book quantity across bid and ask
dollar_depth_bidBid Dollar DepthLast bid-side top-of-book notional
dollar_depth_askAsk Dollar DepthLast ask-side top-of-book notional
total_dollar_depthTotal Dollar DepthLast total top-of-book notional across bid and ask
spread_avgAvg SpreadAverage bid-ask spread in the interval
spread_bps_avgAvg Spread (bps)Average bid-ask spread in basis points over the interval
spread_depth_ratio_avgAvg Spread/Depth RatioAverage spread-to-depth ratio over the interval
total_depth_avgAvg Total DepthAverage total top-of-book quantity across bid and ask in the interval
dollar_depth_bid_avgAvg Bid Dollar DepthAverage bid-side top-of-book notional in the interval
dollar_depth_ask_avgAvg Ask Dollar DepthAverage ask-side top-of-book notional in the interval
total_dollar_depth_avgAvg Total Dollar DepthAverage total top-of-book notional across bid and ask in the interval
Example Request
from datetime import date
from aperiodic import get_metrics
df = get_metrics(
    api_key="YOUR_API_KEY",
    metric="l1_liquidity",
    exchange="binance-futures",
    symbol="perpetual-BTC-USDT:USDT",
    interval="1d",
    start_date=date(2024, 1, 1),
    end_date=date(2024, 3, 1),
)
print(df.head())

Query Parameters

timestampreqstring
string

Timestamp source. 'exchange' uses the exchange-reported timestamp, 'true' uses actual arrival time at our servers.

exchangetrue
intervalreqstring
string

Aggregation time interval for the data.

1m5m15m30m1h4h1d
exchangereqstring
string

Source exchange for the data.

binance-futuresokx-perpshyperliquid-perps
symbolreqstring
string

Trading pair symbol in the format of Atlas' universal symbology: https://github.com/aperiodic-io/atlas

start_datereqstring<date>
string<date>

Start date for the data range (YYYY-MM-DD format). Data is partitioned by year and month.

end_datereqstring<date>
string<date>

End date for the data range (YYYY-MM-DD format). Must be greater than or equal to start_date.

Successful response with download URLs for each monthly file

Schema
filesobject[]required

Array of file information for each month in the requested date range

yearintegerrequired

Year of the data file

monthintegerrequired

Month of the data file (1-12)

urlstring<uri>required

Presigned URL for direct file download (valid for 5 minutes). URLs are served from dataset-specific subdomains, e.g. ohlcv.aperiodic.io, trade-metrics.aperiodic.io, l1-metrics.aperiodic.io, l2-metrics.aperiodic.io, derivative-metrics.aperiodic.io.

Example
{
  "files": [
    {
      "year": 2024,
      "month": 1,
      "url": "https://ohlcv.aperiodic.io/binance-futures/1h/BTCUSDT/2024-01.parquet?X-Amz-Expires=300&..."
    },
    {
      "year": 2024,
      "month": 2,
      "url": "https://ohlcv.aperiodic.io/binance-futures/1h/BTCUSDT/2024-02.parquet?X-Amz-Expires=300&..."
    }
  ]
}
Try It
Suggestions shown — any valid value accepted
Suggestions shown — any valid value accepted
Suggestions shown — any valid value accepted
Authentication
An API key is required to send requests.Sign up
GET/api/v1/data/l1_liquidity?timestamp=exchange&interval=1m&exchange=binance-futures
Response will appear here
Aperiodic

Institutional-Grade Order Flow, Liquidity & Derivative Metrics — Turn market microstructure into actionable signals, alpha and analytics in minutes.

© Copyright 2026 Aperiodic. All Rights Reserved.

Product
  • Data Catalog
  • Pricing
  • API Docs
  • Notebooks
  • Roadmap
  • Changelog
  • FAQ
  • For AI Agents
Metrics
  • Order Flow
  • L1 — Top of Book
  • L2 — Order Book
  • Market Data
  • Derivatives
Channels
  • Research Insights
  • Microstructure Guide
  • Telegram
  • Twitter/X
  • LinkedIn
Company
  • Contact
  • Book a call
  • Terms of Service
  • Privacy Policy
  • LLM? Read this.

NOT INVESTMENT ADVICE

The Content is for informational purposes only, you should not construe any such information or other material as legal tax, investment, financial, or other advice. Nothing contained on our presentation constitutes a solicitation, recommendation, endorsement, or offer by Aperiodic or any third party service provider to buy or sell any securities or other financial instruments in this or in in any other jurisdiction in which such solicitation or offer would be unlawful under the securities laws of such jurisdiction.

All Content on this presentation is information of a general nature and does not address the circumstances of any particular individual or entity. Nothing in the presentation constitutes professional and/or financial advice, nor does any information on the Presentation constitute a comprehensive or complete statement of the matters discussed or the law relating thereto.

Aperiodic is not a fiduciary by virtue of any person's use of or access to the Presentation or Content. You alone assume the sole responsibility of evaluating the merits and risks associated with the use of any information or other Content on the Presentation before making any decisions based on such information or other Content. In exchange for using the Presentation, you agree not to hold Aperiodic, its affiliates or any third party service provider liable for any possible claim for damages arising from any decision you make based on information or other Content made available to you through the Presentation.

INVESTMENT RISKS

There are risks associated with investing in securities. Investing in stocks, bonds, exchange traded funds, mutual funds, and money market funds involve risk of loss. Loss of principal is possible. Some high risk investments may use leverage, which will accentuate gains & losses. Foreign investing involves special risks, including a greater volatility and political, economic and currency risks and differences in accounting methods. A security's or a firm's past investment performance is not a guarantee or predictor of future investment performance.