Installation

Install and configure the Market Motion CLI

Install

npm install -g @marketmotion/cli

Verify the installation:

motion --version

Update

motion update

The CLI checks for updates automatically once per day and notifies you when a new version is available. You can also update manually with npm install -g @marketmotion/cli.

Authentication

1. Get an API key at marketmotion.xyz/developer
2. Authenticate:

motion auth login mt_live_your_key_here

3. Verify:

motion auth status

Quick Start

Search 17,000+ entities:

motion entities search "LeBron James"

Browse trending markets:

motion markets trending

Scan for cross-venue arbitrage:

motion arb scan --min-spread 3

Configuration

The CLI reads configuration from environment variables and a local config file.

Variable	Description	Default
MOTION_API_KEY	API key (overrides stored config)	—
MOTION_API_URL	Base API URL	https://api.marketmotion.xyz

Config is stored at ~/.config/motion/config.json.

You can also set the API key via environment variable instead of motion auth login:

export MOTION_API_KEY=mt_live_your_key_here

Next Steps

Commands Reference

Full list of CLI commands and options

API Reference

Explore the REST API endpoints

Arbitrage Guide

Cross-venue arbitrage strategies

Entity Tracking Guide

Track entities and set up alerts