> ## Documentation Index
> Fetch the complete documentation index at: https://motiontrade.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The intelligence layer for prediction markets

## What is Market Motion?

Market Motion is the **entity intelligence layer** for prediction markets. We provide structured, machine-readable context — canonical entities, typed attributes, explicit relationships, and direct market connections — all with full source provenance.

### The Problem

Markets move on reality. Traders only see prices.

* Critical context is fragmented across ESPN, Twitter, on-chain data, and dozens of sources
* No system connects entity-level changes to the markets they affect
* AI trading systems hallucinate without structured context
* Cross-venue mispricings go undetected without entity mapping

### The Solution

One API call returns what would take hours of manual research to assemble:

* **Canonical Entities** with typed attributes and confidence scores
* **Relationship Graphs** connecting entities to each other and to affected markets
* **Full Provenance** — every data point traced to source, timestamp, and confidence
* **Cross-Venue Intelligence** — same markets on Polymarket and Kalshi, scored by spread

## Key Differentiators

<CardGroup cols={2}>
  <Card title="The Taxonomy" icon="database">
    Hierarchical ontology organizing all market-relevant information. Categories, subcategories, groups — all machine-readable and traversable.
  </Card>

  <Card title="Relationship Intelligence" icon="chart-network">
    Explicit typed relationships: Mahomes plays\_for Chiefs, plays\_at Arrowhead. Traverse the graph to find second-order market effects.
  </Card>

  <Card title="Structured Output" icon="code">
    Typed entity models, not raw text. AI systems consume our output directly — no parsing, no extraction, no hallucination.
  </Card>

  <Card title="Market-Native" icon="trending-up">
    Every entity links to affected markets. When an entity attribute changes, you know exactly which markets are impacted.
  </Card>
</CardGroup>

## Who is this for?

* **AI Trading Systems** — Feed structured entity context to autonomous agents
* **Quant Researchers** — Analyze entity relationships and market correlations at scale
* **Arbitrage Detection** — Cross-venue price discrepancies with entity-level mapping
* **Market Intelligence** — Track how entity attribute changes propagate to markets

## Quick Links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Query your first entity in under 5 minutes
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore all available endpoints
  </Card>

  <Card title="Entity Explorer" icon="chart-network" href="https://marketmotion.xyz/entities">
    Browse the entity taxonomy visually
  </Card>

  <Card title="LLM Context" icon="robot" href="/docs/llms.txt">
    Machine-readable API reference for AI tools
  </Card>
</CardGroup>