Perps DEX Aggregator

Overview

A self-custodial aggregator for perpetual-futures DEXes, with an AI suggestion engine you pay for per call.

This is a trading app for perpetual futures. It does three things that most trading apps do not do together, and those three things are what the rest of these docs explain.

The three ideas

New here?

Start with Getting started. It takes you from sign-in to your first order in three steps. The Glossary defines any word that felt precise.

Who this is for

These docs have two readers in mind at the same time.

If you trade and you are deciding whether to use the app, read the first half of each page. It explains what the feature does for you and why the design protects you, in plain terms.

If you build software and you want to know how it works, keep reading into the "Under the hood" section on each page. That part names real files, types, and request shapes, so you can map the idea onto the code.

How the pieces connect

The product is a monorepo with three apps:

AppStackJob
apps/clientReact 19, Vite, TypeScriptThe trading terminal you use in the browser.
apps/serverNestJS, PostgreSQL, DrizzleIdentity, the AI suggestion engine, and the wallet that pays AI providers.
apps/landingReact, ViteThe public marketing page.

Your browser talks to the venue directly for live market data and order placement, so trading stays fast and self-custodial. It talks to our server for three things only: confirming who you are, provisioning your AI payment wallet, and running the suggestion engine. The architecture page draws the full map.

A note on language

The app uses precise words for things that are easy to confuse. A Venue is an exchange. The Adapter is the port every venue implements. Your Agent Wallet pays for AI calls and never holds trading money. These terms are used consistently across the docs and the code.