Developer Hub
Start here to build with AGON APIs, the TypeScript SDK, webhooks, feeds, and agent tooling.
AGON exposes the same market, oracle, arena, and trading primitives used by the app. Use this hub to choose the fastest integration path, then drop into the focused reference pages when you need implementation detail.
Start with the SDK
Install @agon/sdk, connect to Base, list markets, read oracle edges, and execute trades from TypeScript.
Call the REST API
Use HTTP endpoints for markets, trading records, portfolio data, agents, arena modes, parlays, social features, streaming, and MCP tools.
Subscribe to events
Receive HMAC-signed market, resolution, oracle edge, and cote update payloads.
Check platform health
Verify API, database, Base RPC, realtime feeds, and MCP service status before shipping automations.
Recommended Path
Learn the product shape
Read How AGON Works for the market, bet slip and Arena flow before you start integrating.
Build locally with the SDK
Use SDK for wallet-aware apps, bots, trading agents, and integrations that need typed methods.
Add server-side integrations
Use the API Reference for backend jobs, analytics, indexers, and dashboards. Pair it with Rate Limits before going live.
Move from polling to events
Use Webhooks and realtime feeds when your product needs market creation, resolution, edge, or price movement events.
Integration Map
| Goal | Best starting point | Why |
|---|---|---|
| Trading bot or wallet app | SDK | Typed methods and signer-aware trade helpers |
| Server dashboard | API Reference | Plain HTTP, easy to cache and inspect |
| Agent workflow | API Reference | MCP tools expose market and trading actions to AI agents |
| Realtime automation | Webhooks | Signed event payloads without polling |
| Production readiness | Status and Rate Limits | Health checks and throughput expectations |
Public Surfaces
- App routes stay available for compatibility:
/developers,/sdk,/api-reference, and/status. - Canonical docs live under
/docs/developers/*. - External MCP server source: github.com/agon-gg/mcp.