Aperiodic
DataFactors
Catalog
Pricing
Get Started

Price Range & Distribution

Intrabar high-low price range and full distribution statistics (mean, median, std, skewness, kurtosis) for trade prices within each interval.

CodeAPI DocsTry It

range_bps

Range (bps)

Range in basis points expresses the bar high-low spread in a way that is directly comparable across symbols and price levels.

That normalization makes it much more actionable than a raw absolute range when you are screening for unusually active intervals.

price_std

Price Std Dev

Price Std Dev measures how dispersed transaction prices were around the mean within the interval.

Unlike the simple high-low range, it tells you whether activity was broadly scattered or concentrated near a central level.

price_skewness

Price Skewness

Price Skewness captures whether the distribution of trade prices leaned toward the upper or lower tail of the interval.

Positive skew often means occasional bursts to the upside, while negative skew suggests the heavier excursions were downward.

price_kurtosis

Price Kurtosis

Price Kurtosis highlights whether price observations were tightly clustered with a few extreme prints or more evenly spread out.

Elevated kurtosis is often a clue that the interval contained bursts, tails, or jump-like behavior despite a modest average move.

price_cv

Price CV

Price CV scales standard deviation by the mean price, creating a relative dispersion measure.

It is especially helpful when comparing instruments with very different nominal prices or when monitoring how variability changes through time.

A candlestick reduces thousands of trades to four numbers: open, high, low, close. This compression discards the path — and the path contains information that the endpoints don't.

Endpoint

/api/v1/data/range

Category

Trades

Intervals
1m5m15m30m1h4h1d
Requires Institutional
15s30s
Exchanges
binance-futuresokx-perpshyperliquid-perps
Fields10
rangePrice RangeHighest trade price minus lowest trade price
range_bpsRange (bps)High-low trade price range in basis points of the closing price
price_meanMean PriceAverage trade price in the interval
price_medianMedian PriceMedian trade price in the interval
price_stdPrice Std DevStandard deviation of trade prices in the interval
price_variancePrice VarianceVariance of trade prices in the interval
price_skewnessPrice SkewnessSkewness of the trade-price distribution
price_kurtosisPrice KurtosisKurtosis of the trade-price distribution
price_range_ratioPrice Range RatioHighest trade price divided by lowest trade price
price_cvPrice CVCoefficient of variation of trade price
Example Request
from datetime import date
from aperiodic import get_metrics

# Free preview — no API key required
df = get_metrics(
    metric="range",
    exchange="binance-futures",
    symbol="perpetual-BTC-USDT:USDT",
    interval="5m",
    timestamp="exchange",
    start_date=date(2025, 5, 1),
    end_date=date(2025, 5, 31),
    preview=True,
)

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. Sub-minute intervals (15s, 30s) require a Tier 3 subscription.

15s30s1m5m15m30m1h4h1d
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 every file covering the range — one per month before 2026-08-01, one per day from 2026-08-01 onwards

Schema
filesobject[]required

Files covering the requested date range, in chronological order. Data before 2026-08-01 is split by month (one file per calendar month, no `day`); data from 2026-08-01 onwards is split by day (one file per calendar day, with `day` set). The changeover falls on a month boundary, so a given month is served entirely one way or the other; a range spanning it returns the earlier months as monthly files followed by a daily file per day.

yearintegerrequired

Year of the data file

monthintegerrequired

Month of the data file (1-12)

dayinteger

Day of the data file (1-31). Present only on daily files, i.e. those covering 2026-08-01 onwards. Absent on monthly files, which cover an entire calendar month.

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": 2026,
      "month": 6,
      "url": "https://ohlcv.aperiodic.io/binance-futures/1h/BTCUSDT/2026-06.parquet?X-Amz-Expires=300&..."
    },
    {
      "year": 2026,
      "month": 7,
      "url": "https://ohlcv.aperiodic.io/binance-futures/1h/BTCUSDT/2026-07.parquet?X-Amz-Expires=300&..."
    },
    {
      "year": 2026,
      "month": 8,
      "day": 1,
      "url": "https://ohlcv.aperiodic.io/binance-futures/1h/BTCUSDT/2026-08-01.parquet?X-Amz-Expires=300&..."
    },
    {
      "year": 2026,
      "month": 8,
      "day": 2,
      "url": "https://ohlcv.aperiodic.io/binance-futures/1h/BTCUSDT/2026-08-02.parquet?X-Amz-Expires=300&..."
    }
  ]
}
Try It

Prefilled with the shared DEMO-KEY and a free preview slice — send the request to see live data, no account required.

Suggestions shown — any valid value accepted
Suggestions shown — any valid value accepted
Suggestions shown — any valid value accepted
Authentication
GET/api/v1/data/preview/range?timestamp=exchange&interval=5m&exchange=binance-futures&symbol=perpetual-BTC-USDT%3AUSDT&start_date=2025-05-01&end_date=2025-05-31
Response will appear here

Try Free Preview Data

Access a curated slice of real production data with just an account — no credit card or subscription required. Pair it with our research notebooks to get started instantly.

Use with AI Agents

Access Price Range & Distribution programmatically via our Python SDK and REST API — optimised for autonomous research workflows.

Get Started

Subscribe to get full API access. Start querying all datasets in minutes.

Aperiodic

Crypto microstructure, liquidity & flow metrics — built from hundreds of terabytes of raw data, distilled into point-in-time metrics you can pull as parquet files.

Registered office
Aperiodic Limited
136 Capel StreetDublin, D01 T2C9Ireland
Registered in Ireland · Company No. 815273

© Copyright 2026 Aperiodic. All Rights Reserved.

Product
  • Data Catalog
  • Pricing
  • API Docs
  • Notebooks
  • Find new alpha
  • Roadmap
  • Changelog
  • FAQ
  • For AI Agents
Metrics
  • Order Flow
  • L1 — Top of Book
  • L2 — Order Book
  • Market Data
  • Derivatives
Channels
  • Blog: Research Insights
  • Microstructure Guide
  • Aperiodic vs. Tardis
  • Aperiodic vs. CoinGlass
  • LinkedIn
Company
  • Contact
  • Book a call
  • Terms of Service
  • Privacy Policy
  • LLM? Read this.

Provided for informational purposes only; not investment advice, a recommendation, or an offer to transact. Past performance is not indicative of future results.