Quickstart

Get started with Market Motion in 5 minutes

Base URL

All API requests go to:

https://api.marketmotion.xyz/api

Your First Request

No API key needed to get started. Let’s fetch an entity:

cURL

curl "https://api.marketmotion.xyz/api/entities/patrick-mahomes"

Prefer the terminal? Install the Market Motion CLI and run motion entity patrick-mahomes instead.

Response

{
  "success": true,
  "entity": {
    "id": "uuid",
    "slug": "patrick-mahomes",
    "displayName": "Patrick Mahomes",
    "entityType": "person",
    "category": "sports",
    "subcategory": "nfl",
    "attributes": {
      "position": "Quarterback",
      "jersey_number": "15",
      "injury_status": "healthy"
    },
    "relationships": [
      {
        "role": "plays_for",
        "entity": {
          "slug": "kansas-city-chiefs",
          "displayName": "Kansas City Chiefs",
          "entityType": "team"
        }
      }
    ],
    "marketExposures": [
      {
        "role": "subject",
        "market": {
          "title": "Chiefs to win Super Bowl LIX",
          "venue": "polymarket"
        }
      }
    ]
  }
}

What You Get

With a single API call, you receive:

Field	Description
attributes	Typed key-value data (injury status, position, etc.)
relationships	Connections to other entities (team, stadium, league)
marketExposures	All prediction markets involving this entity

Search for Entities

Find entities by name:

curl "https://api.marketmotion.xyz/api/entities?q=mahomes"

List Markets

Get prediction markets with filtering:

curl "https://api.marketmotion.xyz/api/markets/predictions?category=sports&venue=polymarket&limit=10"

Get Relationship Graph

Visualize entity connections:

curl "https://api.marketmotion.xyz/api/entities/patrick-mahomes/graph?depth=2"

Returns nodes and edges for graph visualization.

Next Steps

Authentication

Get an API key for higher rate limits

Core Concepts

Understand entities, relationships, and markets

API Reference

Explore all endpoints

AI Trading Guide

Build AI trading systems with Market Motion