For AI Agents
Agent Quickstart
Aperiodic sells point-in-time market microstructure, liquidity and order-flow metrics for RWA perps (stocks, ETFs, commodities and FX) and crypto perps: 220 metrics in 19 datasets on binance-futures, okx-perps, hyperliquid-perps, delivered as parquet through a CLI, a REST API, a Python SDK and an MCP server for AI agents, plus the raw trades, quotes and derivatives data behind them in the Prime + Raw plan. A preview slice of every dataset downloads with no API key, and self-serve plans cost $199 to $1499 a month billed yearly.
Read https://aperiodic.io/start.md and follow it.Install the CLI and pull one month of 5m flow data for perpetual-BTC-USDT:USDT on binance-futures as parquet. The preview accepts only this window (2025-05-01 to 2025-05-31, 5m), for every dataset: swap flow for any dataset id.
# Install the Aperiodic CLI into ~/.local/bin
mkdir -p "$HOME/.local/bin"
curl -fsSL https://raw.githubusercontent.com/aperiodic-io/cli/main/install.sh | INSTALL_DIR="$HOME/.local/bin" bash
export PATH="$HOME/.local/bin:$PATH"
aperiodic flow --preview \
--exchange binance-futures \
--symbol perpetual-BTC-USDT:USDT \
--interval 5m \
--timestamp exchange \
--start-date 2025-05-01 \
--end-date 2025-05-31 \
--output-dir ./dataThe SDK returns DataFrames. The same preview slice works from Python with preview=True, still without a key.
pip install "aperiodic[polars]"Your user creates a key at https://aperiodic.io/home/api. Any other symbol, interval or date range needs a key and a plan that includes the dataset's tier (flow is Pro; see https://aperiodic.io/pricing).
from datetime import date
from aperiodic import get_metrics
df = get_metrics(
api_key="YOUR_API_KEY",
metric="flow",
exchange="binance-futures",
symbol="perpetual-BTC-USDT:USDT",
interval="1h",
timestamp="exchange",
start_date=date(2025, 1, 1),
end_date=date(2025, 3, 1),
)What to Tell Your User About the Licence
Why Agents Need Structured Market Data
How Aperiodic is Built for Agents
Connect Claude, ChatGPT or Cursor to every dataset at aperiodic.io/mcp. Tools return schemas, statistics and signed Parquet handles, so the data reaches your agent's code, not its context.
Connect over MCP →pip install "aperiodic[polars]" — one-line access to every dataset. Agents can fetch DataFrames directly without parsing raw API responses.
View on PyPI →Concise summary at /llms.txt, comprehensive reference at /llms-full.txt — agents get exactly the depth they need.
Read llms-full.txt →Full OpenAPI 3.0 spec for tool-use integration. Agents can auto-generate API calls from the spec without custom code.
View OpenAPI spec →Google A2A-compliant agent discovery at /.well-known/agent.json — capabilities, auth, and skills declared for agent-to-agent orchestration.
View agent card →Standard ai-plugin.json at /.well-known/ai-plugin.json for ChatGPT-style plugin discovery and authentication.
View manifest →Agent Workflow Examples
An agent fetches OHLCV, funding rates, and order flow data to produce a daily market report. It identifies unusual flow toxicity spikes, extreme funding regimes, and OI divergences — then summarizes findings for a human analyst.
An agent constructs cross-sectional factors from microstructure data: flow imbalance, funding carry, spread, and volatility factors. It computes information coefficients and long-short portfolio returns to evaluate which signals have predictive power.
Quick Start
Point your agent to these resources:
pip install "aperiodic[polars]"X-API-KEY: YOUR_KEYFAQ
Yes, for the preview slice. Every dataset can be fetched with no key for binance-futures perpetual-BTC-USDT:USDT at 5m, from 2025-05-01 to 2025-05-31, through the CLI (--preview), the SDK (preview=True), the MCP server at https://aperiodic.io/mcp or the REST preview endpoint with the shared key DEMO-KEY. Anything outside that window needs a personal key.
Yes, over MCP: add https://aperiodic.io/mcp to the app (in Claude Code, claude mcp add --transport http aperiodic https://aperiodic.io/mcp). With no key it serves the free preview; sign in, or send your API key in X-API-KEY, for everything your plan includes. Its tools return the catalog, schemas, statistics and signed Parquet links, so the data reaches the agent's code rather than its context. Setup for each app: https://aperiodic.io/mcp.
220 metrics in 19 datasets: order flow, trade size, slippage, price impact, L1 and L2 order book liquidity and imbalance, funding, basis, open interest and OHLCV. Exchanges: binance-futures, okx-perps, hyperliquid-perps. Self-serve intervals: 1m, 5m, 15m, 30m, 1h, 4h, 1d. The machine-readable list is https://aperiodic.io/catalog.json.
Parquet files, fetched through the aperiodic CLI, the REST API or the Python SDK (pip install "aperiodic[polars]"), which loads them into DataFrames. AI agents can also get signed links to the same files from the MCP server at https://aperiodic.io/mcp.
Self-serve plans cost $199 to $1499 a month billed yearly, or $249 to $1899 month to month. Institutional pricing is quoted. Current plans: https://aperiodic.io/pricing.
Pro, Prime: personal-use licence, the subscriber's own research only. Prime Commercial, Prime + Raw: commercial licence, internal business use within the subscriber's organization.
Get an API key and start querying 19 datasets in minutes.
Shown: minute lows of the 465 Binance perpetuals, 20:40–22:00 UTC on 10 Oct 2025, with BTC’s path traced · built with ohlcv 1m