# Aperiodic

> Institutional-grade crypto market microstructure data platform for quants and AI agents. 19 pre-aggregated datasets across order flow, L1/L2 book data, derivatives, and OHLCV.

## Documentation

- [Full LLM Reference](https://aperiodic.io/llms-full.txt): Complete API reference, all datasets, fields, error codes, and pricing
- [OpenAPI 3.0 Specification](https://aperiodic.io/api.data.specification.json): Machine-readable API spec for tool-use integration
- [AI Plugin Manifest](https://aperiodic.io/.well-known/ai-plugin.json): Agent platform discovery
- [A2A Agent Card](https://aperiodic.io/.well-known/agent.json): Agent-to-agent discovery (Google A2A protocol)
- [API Documentation](https://aperiodic.io/api-docs): Human-readable API docs

## Quick Start

- **Base URL**: `https://aperiodic.io/api/v1/data/{bucket}`
- **Auth**: `X-API-KEY` header (get key at https://aperiodic.io/home/api)
- **Python SDK**: `pip install aperiodic`
- **Exchanges**: `binance-futures`, `okx-perps`
- **Intervals**: `1m`, `5m`, `15m`, `30m`, `1h`, `4h`, `1d`

## Datasets

19 datasets organized in 5 categories:

- **Trades**: `flow`, `trade_size`, `range`, `impact`, `updownticks`, `run_structure`, `returns`, `slippage`
- **Derivatives**: `basis`, `funding`, `open_interest`, `derivative_price`
- **Market**: `ohlcv`, `vtwap`
- **L1 (Top of Book)**: `l1_price`, `l1_imbalance`, `l1_liquidity`
- **L2 (Order Book)**: `l2_imbalance`, `l2_liquidity`

## Agent Resources

- [Agent Integration Guide](https://aperiodic.io/agents): Human-readable guide to using Aperiodic with AI agents
- [.agent pages](https://aperiodic.io/agents.agent): Append `.agent` to URLs for LLM-readable markdown (e.g. `/catalog/flow.agent`)
- [Market Analysis Skill](https://aperiodic.io/skills/market-analysis.md): Claude skill for market data analysis
- [Factor Research Skill](https://aperiodic.io/skills/factor-research.md): Claude skill for cross-sectional factor construction
- [Backtest Skill](https://aperiodic.io/skills/backtest-strategies.md): Claude skill for strategy backtesting

## Links

- Catalog: https://aperiodic.io/catalog
- Pricing: https://aperiodic.io/pricing
- Sign up: https://aperiodic.io/auth/sign-up
- Contact: info@aperiodic.io