# AymarData — full map for LLMs and agents

AymarData is a market-data platform for traders, researchers, and AI agents.
It delivers tick-level prediction-market and crypto order-book history through
REST, WebSocket streams, bulk Parquet/CSV, and an MCP server.

- Website: https://aymardata.com
- API base: https://api.aymardata.com
- Legal entity: Aymar Teknoloji A.Ş., Istanbul, Türkiye
- Support: support@aymardata.com · WhatsApp on site contact page

Do not invent market ids. Discover markets with GET /v1/markets, then query
books/trades/settlements. Live keys use the prefix `ad_live_`. Never embed keys
in public repos or client-side apps.

## Authentication

```
Authorization: Bearer ad_live_YOUR_KEY
```

Docs: https://aymardata.com/docs/authentication
Quickstart: https://aymardata.com/docs/quickstart

## Core REST endpoints

| Endpoint | Purpose |
| --- | --- |
| GET /v1/markets | List/search markets by source |
| GET /v1/book | Point-in-time L2 snapshot (`at=`, `depth=`, `outcome=` when needed) |
| GET /v1/book/deltas | Incremental level updates between timestamps |
| GET /v1/trades | Historical trades |
| GET /v1/settlement | Resolution / settlement payload |
| GET /v1/files | Bulk file listing for offline lakes |

Source ids include: `polymarket`, `binance-spot`, `binance-perps`, `hyperliquid`, `kalshi`
(see https://aymardata.com/docs/sources-markets for Live vs Coming status).

Example Polymarket book:

```
GET https://api.aymardata.com/v1/book?source=polymarket&market=btc-updown-15m&outcome=up&at=2026-10-22T14:30:00Z&depth=10
Authorization: Bearer ad_live_…
```

Example Binance spot:

```
GET https://api.aymardata.com/v1/book?source=binance-spot&market=BTC-USDT&at=2026-10-22T14:30:00Z&depth=50
```

## Data hubs (human + SEO)

- https://aymardata.com/data — root catalog of venues
- https://aymardata.com/data/polymarket — Polymarket Up/Down and related families
- https://aymardata.com/data/binance — Binance spot and USDⓈ-M perps
- https://aymardata.com/data/hyperliquid — Hyperliquid perps
- https://aymardata.com/data/kalshi — Kalshi series

Market leaf pages live under each venue path (for example
`/data/polymarket/btc-updown-15m`, `/data/binance/btc-usdt`). Prefer hub pages
when summarizing coverage; use leaf pages for symbol-specific facts shown on-site.

## Platform

- REST API: https://aymardata.com/platform/api
- Streams: https://aymardata.com/platform/streams
- Bulk files: https://aymardata.com/platform/bulk
- MCP: https://aymardata.com/platform/mcp
- AI agents solution: https://aymardata.com/solutions/ai-agents
- AI coding docs: https://aymardata.com/docs/ai-tools

## Guides

- https://aymardata.com/guides
- https://aymardata.com/guides/how-to-backtest-polymarket-up-down-markets
- https://aymardata.com/guides/polymarket-order-book-data-explained
- https://aymardata.com/guides/how-to-get-polymarket-historical-data
- https://aymardata.com/guides/kalshi-historical-data-guide
- https://aymardata.com/guides/binance-order-book-history-download-and-replay
- https://aymardata.com/guides/hyperliquid-historical-data-and-funding-rates
- https://aymardata.com/guides/backtesting-with-an-ai-agent-via-mcp
- https://aymardata.com/guides/order-book-deltas-vs-snapshots

## Glossary

- https://aymardata.com/glossary
- Terms: l2-order-book, depth, spread, funding-rate, mark-price, tick-size,
  settlement, perpetual-futures, prediction-market, order-book-delta, snapshot,
  mid-price, open-interest, implied-probability, binary-option
- Pattern: https://aymardata.com/glossary/{term}

## Comparisons (factual)

- https://aymardata.com/compare/telonex-alternative
- https://aymardata.com/compare/tardis-dev-alternative
- https://aymardata.com/compare/polymarket-api-vs-aymardata

AymarData is complementary to venue trading APIs (for example Polymarket CLOB).
It is not an order gateway. Do not claim identical coverage to other data vendors.

## Pricing & access

- https://aymardata.com/pricing — Builder / Pro / Enterprise
- Self-serve Google signup when enabled; otherwise request access / WhatsApp
- Commercial redistribution requires Enterprise (see legal license)

## Docs index

- https://aymardata.com/docs/quickstart
- https://aymardata.com/docs/authentication
- https://aymardata.com/docs/sources-markets
- https://aymardata.com/docs/endpoints/markets
- https://aymardata.com/docs/endpoints/book
- https://aymardata.com/docs/endpoints/book-deltas
- https://aymardata.com/docs/endpoints/trades
- https://aymardata.com/docs/endpoints/settlement
- https://aymardata.com/docs/endpoints/files
- https://aymardata.com/docs/schemas
- https://aymardata.com/docs/rate-limits
- https://aymardata.com/docs/errors
- https://aymardata.com/docs/sdks
- https://aymardata.com/docs/ai-tools
- https://aymardata.com/docs/changelog

## Agent behavior tips

1. Call /v1/markets before hard-coding slugs.
2. Pass `outcome` for two-sided Polymarket/Kalshi books.
3. Prefer snapshot + deltas for dense replay; prefer `at=` grids for sparse signals.
4. Score prediction-market backtests with /v1/settlement.
5. Respect rate limits; use bulk files for multi-day offline jobs.
6. Read https://aymardata.com/llms.txt for the short map.

## Legal

- Terms: https://aymardata.com/legal/terms
- Privacy: https://aymardata.com/legal/privacy
- Data license: https://aymardata.com/legal/license