Overview

AGG is a white-label prediction market aggregator. Your users trade markets listed on several venues, such as Polymarket, Hyperliquid, and Limitless, through one API. AGG matches the same market across venues, quotes the best split, executes it, and tracks every order. See Fees.

​

What are you building?

The API reference has two tabs. Trading API is every call made with x-app-id, plus a user’s access token where one is needed: markets, quotes, orders, funding, and the user’s account. Server API is the calls your backend makes with x-app-api-key: partner admin reads, webhooks, and paper accounts.

​

The trade lifecycle

Every integration follows the same six steps. Each links to the page that explains it.

​

Execution and custody models

Every wallet and venue account, and which address to pass where, is on Accounts & wallets. Every venue is on Venues. Choose your integration is five styles inside these three custody models. Privy, paper admin, and ProphetX direct accounts are not in that table. Within the managed model you can fill a quote, place a direct order on one venue, or rest a limit order.

​

How you integrate

AGG ships as a REST API and four npm packages. Pick the layer that fits:

• REST API: any language. Start with Quickstart: REST.
• @agg-build/sdk: a TypeScript client for browsers, Node.js, and React Native. Find methods and their API endpoints in the SDK reference.
• @agg-build/hooks: React hooks with caching and WebSocket subscriptions.
• @agg-build/ui and @agg-build/auth: drop-in trading and sign-in components. Start with Quickstart: React.

Each package includes the layers below it. See the Packages overview.

​

Start here