# multi — the cross-platform perp DEX aggregator

> The cross-platform perp DEX aggregator. One order is quoted against every major perp venue (Hyperliquid, Aster, Lighter, Pacifica, Pear, Avantis), routed to the books that fill it best, and reported back as one position under one margin view — exposed as one REST API, an MCP server, and typed SDKs (TypeScript + Python). Cross-chain routing across 70+ networks is how you fund venue margin, not the headline. Public market data is open; execution uses a scoped `multi_sk_` agent key with risk limits enforced server-side before any order reaches a venue. API base: https://multi-venym-labs.vercel.app/api

## Start
- [Overview](https://multi-venym-labs.vercel.app/docs): What multi aggregates and what the API exposes.
- [Quickstart](https://multi-venym-labs.vercel.app/docs/quickstart): Key → first aggregated quote → first routed trade in 5 minutes.
- [Authentication](https://multi-venym-labs.vercel.app/docs/authentication): Agent API keys, scopes, and per-key risk limits.

## Harnesses
- [One-command install](https://multi-venym-labs.vercel.app/docs/harnesses#cli): npx @multidex/agent-kit init <harness> — writes the config for you.
- [Claude Code](https://multi-venym-labs.vercel.app/docs/harnesses#claude-code): Add the multi MCP server via .mcp.json (stdio or HTTP).
- [Codex CLI](https://multi-venym-labs.vercel.app/docs/harnesses#codex): Add via ~/.codex/config.toml [mcp_servers.multi].
- [OpenCode](https://multi-venym-labs.vercel.app/docs/harnesses#opencode): Add via opencode.json mcp (local or remote).
- [Hermes Agent](https://multi-venym-labs.vercel.app/docs/harnesses#hermes): Add via ~/.hermes/config.yaml mcp_servers.
- [OpenClaw](https://multi-venym-labs.vercel.app/docs/harnesses#openclaw): Add via ~/.openclaw/openclaw.json mcp.servers.
- [Cursor](https://multi-venym-labs.vercel.app/docs/harnesses#cursor): Add via ~/.cursor/mcp.json (or project .cursor/mcp.json).
- [Windsurf](https://multi-venym-labs.vercel.app/docs/harnesses#windsurf): Add via ~/.codeium/windsurf/mcp_config.json.
- [Gemini CLI](https://multi-venym-labs.vercel.app/docs/harnesses#gemini): Add via ~/.gemini/settings.json mcpServers.

## SDKs
- [TypeScript](https://multi-venym-labs.vercel.app/docs/sdk#typescript): @multidex/sdk — install, auth, examples per capability.
- [Python](https://multi-venym-labs.vercel.app/docs/sdk#python): multidex-sdk — install, auth, examples per capability.

## MCP & Skills
- [MCP server](https://multi-venym-labs.vercel.app/docs/mcp): Local stdio (npx @multidex/mcp) and remote HTTP.
- [Tool reference](https://multi-venym-labs.vercel.app/docs/mcp#tools): Every MCP tool, its inputs, and required scope.
- [Agent skills](https://multi-venym-labs.vercel.app/docs/skills): Drop-in SKILL.md skills for analysis, trading, pairs, and swaps.

## REST API
- [Reference](https://multi-venym-labs.vercel.app/docs/api): Every endpoint: market data, streaming, orders, pair trades, swaps, keys.

## Guides
- [Recipes](https://multi-venym-labs.vercel.app/docs/recipes): Stream prices, route a trade, pair trade, fund cross-chain, run an agent loop.
- [Safety](https://multi-venym-labs.vercel.app/docs/safety): Risk gates, scopes, idempotency, custody, errors, rate limits.

## Quick start
- Local MCP server (works in Claude Code, Codex, OpenCode, Hermes, OpenClaw): `npx -y @multidex/mcp` — set `MULTI_API_KEY` for execution.
- Remote MCP server: https://multi-venym-labs.vercel.app/mcp (send `Authorization: Bearer multi_sk_...`).
- TypeScript SDK: `npm i @multidex/sdk`  ·  Python SDK: `pip install multidex-sdk`

## Optional
- [Full reference](https://multi-venym-labs.vercel.app/llms-full.txt): every endpoint and MCP tool, inlined.
- [OpenAPI 3.1 spec](https://multi-venym-labs.vercel.app/openapi.json): machine-readable API description.