Agara Trading API
Place orders, read live depth, and monitor fills on AGARA markets.
REST origin: https://app.agara.xyz · WebSocket origin: wss://app.agara.xyz
Trading endpoints live under /trade/v1; market discovery lives under
/api/v1.
Where to start
Quickstart
Discover a market, place an order, and confirm a fill.
Authentication
Create a scoped personal access token and send it safely.
Wallet setup
Prepare and fund the AGARA deposit wallet used by your market-making account.
Conventions
Amount units, identifiers, errors, and asynchronous status lifecycles.
Reference
Markets
Discover events and the condition_id and token_id values used by trading calls.
Orders
Place, list, inspect, and cancel orders.
Orderbook
Read live bid and ask depth.
Streaming
Receive real-time market data.
Portfolio
Reconcile collateral, positions, fills, orders, and activity.
Account stream
Receive private order, fill, position, redemption, and collateral updates.
Tokens
Verify the active collateral and AGARA contract addresses before signing or moving funds.
Endpoint summary
| What you want to do | Method | Path |
|---|---|---|
| Browse or search events | GET | /api/v1/events?source=AGARA |
| Read one event and its markets | GET | /api/v1/events/{slug} |
| Place an order | POST | /trade/v1/orders |
| List your orders | POST | /trade/v1/orders/list |
| Look up one order | GET | /trade/v1/orders/{order_id} |
| Cancel an order | DELETE | /trade/v1/orders/{order_id} |
| Cancel every open order | POST | /trade/v1/orders/cancel-all |
| Read the orderbook | GET | /trade/v1/orderbook/{token_id} |
| Stream market data | WS | /trade/v1/market-stream |
| Stream account events | WS | /trade/v1/account-stream |
| Read fill history | GET | /trade/v1/portfolio/trades |
Orders and account requests need an Authorization: Bearer <token> header.
Market discovery, orderbooks, and the market stream are public.
Funding in this environment
Production uses real USDC on Base. Verify
the token contract on Collateral before depositing
or withdrawing.
The web app can quote supported cross-chain withdrawals. Query the withdrawal supported-assets endpoint immediately before requesting a route because availability can change.