AiyoPerps is a perpetual futures desktop terminal that supports both CEX (centralized) and DEX (decentralized) trading. It provides a full desktop UI, an MCP server for AI agents, and a local REST API.
All your data is stored locally in SQLite, in the db folder under the program execution path. Your data will not leave the local machine, and you do not need to give any API key to the AI ​​Agent.
With AiyoPerps, you can trade crypto perpetual futures manually, with AI collaboration, or fully driven by AI.

If you think this project is cool, feel free to buy us a coffee!
When you sponsor us, you’ll also get a chance to join Taiwan’s receipt lottery.
That’s because Chen-Si Studio is a team that pays taxes properly. We issue an official receipt/invoice for every bit of income, and those invoice numbers can be checked for prizes every two months.
Even if you don’t live in Taiwan, if your invoice wins, just let us know. We’ll claim the prize for you and then send you the money (after deducting any necessary handling fees).

• Added a Dashboard interface, allowing you to manage all your positions and open orders across all exchanges from a single interface.

• Added a feature to automatically wake up the AI ​​Agent at fixed intervals, supporting Codex CLI, Claude Code CLI, and Gemini CLI.

• A new conditional wake-up AI Agent has been added, which allows you to set the AI ​​Agent to be activated only when the market price or profit reaches a set condition.

• CEX: BitMEX
• DEX: Hyperliquid, Aster, Grvt, dYdX

• Windows, Linux, or macOS (via Docker).
• .NET 10 Runtime (included in release builds).
• A perpetual futures exchange account. Current supported venues are Hyperliquid, BitMEX, dYdX, Grvt, and Aster.

1. Download the latest package from GitHub Releases.
2. Run:
   • Windows: AiyoPerps.exe
   • Linux AppImage:

     chmod +x AiyoPerps-x86_64.AppImage
     ./AiyoPerps-x86_64.AppImage

sha256sum -c AiyoPerps-x86_64.AppImage.sha256

1. Publish the Linux self-contained build: dotnet publish ./AiyoPerps/AiyoPerps.csproj -c Release -r linux-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -o "./publish/linux-x64"
2. On Linux, run: ./scripts/appimage/build-appimage.sh
3. Generate the checksum file: sha256sum ./artifacts/appimage/AiyoPerps-x86_64.AppImage > ./artifacts/appimage/AiyoPerps-x86_64.AppImage.sha256
4. The AppImage and checksum file will be created under ./artifacts/appimage/

1. Clone this repo or download the full source code.
   git clone https://github.com/phidiassj/AiyoPerps.git
2. Build it with Visual Studio 2026.

1. Start the desktop app.
2. In the top toolbar, set the HTTP API port (default 5078).
3. Turn the API switch ON.
4. Open:
   • OpenAPI UI: http://127.0.0.1:5078/scalar
   • MCP endpoint: http://127.0.0.1:5078/mcp

Use this when you only need REST or MCP.

Start the app with -- headless --port 5078.

Windows:
AiyoPerps.exe -- headless --port 5078

Linux:
./AiyoPerps -- headless --port 5078

macOS is currently supported through Docker only.

docker run --rm --name aiyoperps -p 5078:5078 phidiassj/aiyoperps:latest

The container starts automatically in headless mode and enables the HTTP API automatically.

npx -y @phidiassj/aiyoperps-mcp-installer

This registers AiyoPerps with supported AI agents such as Codex, Claude Desktop, Claude Code CLI, and OpenClaw.

npx -y @phidiassj/aiyoperps-mcp-bridge --quiet --url http://127.0.0.1:5078/mcp

If the installer does not support your AI agent, try this manual method.

1. Open Account Manager and add an account.
2. Create or select a tab.
3. Choose the account, then click Enable.
4. Set Symbol and Interval.
5. Use the right-side tabs for Order, Positions, Orders, and Balances.

• Full API and MCP guide: API.md
• 繁體中文 API guide: API_zh.md