From key to movement intelligence
in six calls
Placeholder key shown throughout — replace
YOUR_API_KEY with the key issued to you. Machine-readable version:
?format=json.
Get an API key
Get your free key instantly — no waiting, no email approval. Open /v3/developer/get-key and click Create API Key. Start on Free Sandbox (100 requests/month). Every protected request sends the same header.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/auth/test-key"
Search an exercise
Search is typo-tolerant and alias-aware. Misspellings resolve to the canonical node with a confidence score.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/search?q=back%20squat"
Get a profile
The profile is the centrepiece record: identity, movement family, aliases, variations, graph domains and figure status in one call.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/profile?name=Back%20Squat"
Get a variation tree
Trees return the parent and its full child variation structure — regressions, progressions, equipment and context variations.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/tree?name=Push-Up"
Resolve an alias
Gym shorthand resolves to canonical exercises: “rdl” → Romanian Deadlift, “farmers walk” → Farmer Carry.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/search?q=rdl"
Get graph domains
Graph domains return the modelled biomechanics interpretation layer (Professional plan and above receive the full set with summary).
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/graph-domains?name=Back%20Squat"
const BASE = "https://api.mopro-codex.com";
const res = await fetch(`${BASE}/v3/exercise/search?q=back%20squat`, {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
if (!res.ok) {
const err = await res.json(); // { ok:false, error:"...", message:"..." }
throw new Error(`${err.error}: ${err.message}`);
}
const data = await res.json();
console.log(data.results[0].canonical_exercise_name); // "Back Squat"
console.log(res.headers.get("x-mmsx-monthly-remaining"));
import requests
BASE = "https://api.mopro-codex.com"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
r = requests.get(f"{BASE}/v3/exercise/profile",
params={"name": "Back Squat"}, headers=HEADERS)
r.raise_for_status()
profile = r.json()
print(profile["canonical_exercise_name"]) # Back Squat
print(profile["movement_family"])
print(r.headers["x-mmsx-monthly-remaining"])
Request Beta Access
MoPro-Codex is in private developer beta. Keys are issued directly by MMSx Authority with a plan attached.
MoPro-Codex by TrainersEye Start Quickstart