At a glance
Only managed quote + fill has a paper mode for testing without real
funds. The other options are live only.
Managed quote + fill
GET /orderbook/{venueMarketOutcomeId}/route with the user’s token returns a quoteId that may
split across venues. POST /execution/fill executes it. You show the quote’s price and fees before
the user confirms. Quotes last about 45 seconds.
Start with Quickstart: REST. Concepts: Quotes & smart routing,
Execution.
Direct order
POST /execution/orders places a market order on one venue you name. There is no quote step, and it
never splits. externalId is required, so a timed-out request can be retried without trading twice.
maxSpend caps the all-in cost. Live only.
Guide: Direct order execution.
Limit order
POST /execution/limit-orders rests an order at your price on one venue, with a time in force
(GTC, GTD, FOK, FAK, IOC, ALO; venues support subsets). Funds or shares are reserved
while it is open. Track it with GET /execution/orders?orderId=; open is not final.
Guide: Limit orders.
Self-custody
The user links an EVM wallet to their account. Quotes and fills name it assigningAddress. AGG
prices against that wallet’s balances and then asks the wallet to sign each step: venue orders,
funding moves, and approvals. AGG never holds the key. The user must be present to sign, and each
request expires.
Supported on Polymarket, Hyperliquid, and Kalshi (with the user’s own Kalshi API key). Other venues
are refused at fill time.
Guides: Self-custody trading and
Self-custody signing reference.
Hosted venue account
For BetDEX, AGG can host a venue account for the user. You provision it, read its balance, get a Solana USDC deposit address for it, and withdraw from it. See the Hosted Venue Accounts group in the API Reference, starting with Provision hosted venue account.Where your code runs
Server-only features, such as per-trade
appFeeBips, referral fees, and skipQuote on direct
orders, need x-app-api-key.