Developers

The Agora API gives you the same data and swap routing that agoradex.app runs on, for every launchpad on Elysium.

Open the developer portal → developers.agoradex.app

On the portal you can try every endpoint in your browser, create API keys and claim your builder rewards.

What you can build

Trading bots and terminals. Quote any coin on any launchpad, then get a ready-to-sign transaction for the best route.
Screeners and dashboards. Use the token list, prices, candles, recent trades and top holders.
Safety and rug checkers. Use bubble maps to spot bundled supply and connected wallets before buying.
Wallet trackers and portfolio apps. Read any wallet’s holdings, cost basis, P&L and trade history.

Getting started

Open developers.agoradex.app and sign in with your wallet. Signing is free and sends no transaction.
Create an API key. Keys are free, and each wallet can have up to 5.
Send the key in the x-api-key header:


curl "https://api.agoradex.app/api/v1/tokens?sort=volume&limit=5" \
  -H "x-api-key: YOUR_API_KEY"

	Limit
With a key	300 requests a minute
Without a key	30 requests a minute per IP

Endpoints

Endpoint	Returns
`GET /tokens`	Every coin. Supports search, a launchpad filter, sorting by volume, market cap, newest, gainers, trades or trending, and paging.
`GET /tokens/{address}`	One coin, with its creator, links, holder count, tax and pools.
`GET /tokens/{address}/candles`	OHLC price candles with volume.
`GET /tokens/{address}/trades`	The coin’s recent trades.
`GET /tokens/{address}/holders`	Top holders, with value and P&L.
`GET /tokens/{address}/bubbles`	The bubble map: top holders, the transfers between them, and the clusters of connected wallets (bundles, teams, one owner with many wallets).
`GET /wallets/{address}`	A wallet’s holdings, P&L and totals.
`GET /wallets/{address}/trades`	A wallet’s recent trades.
`GET /quote`	The best price across all venues, plus the swap transaction. Supports HYPE to coin, coin to HYPE, and coin to coin (`payToken`).
`GET /launchpads`	Every supported launchpad.

The full reference, with live examples, is on the portal . An OpenAPI 3.1 spec is at /api/v1/openapi.json. You can import it into Postman or a code generator.

Builder rewards

Swaps built with /quote go through Agora’s router contract.

Claim a builder code in the portal’s Dashboard. This is the same on-chain code as referrals.
Pass it as ref on every quote.

Each swap with your code pays you 30% of Agora’s trading fee in HYPE, and your users get 10% off the fee. The first trade with your code links that wallet to you permanently, so you also earn on its later trades. Earnings build up in the router contract. Claim them from the Dashboard at any time.


const q = await fetch(
  `https://api.agoradex.app/api/v1/quote?token=${coin}&side=buy&amount=0.5&recipient=${user}&ref=yourcode`,
  { headers: { "x-api-key": KEY } },
).then((r) => r.json());
 
// Sign any approvals first (sells only), then send the swap on Elysium (chain id 99901).
await wallet.sendTransaction({ to: q.transaction.to, data: q.transaction.data, value: BigInt(q.transaction.value) });

$AGORA holders pay no fee on Agora, including on swaps built through the API.

Coin to coin

Pass payToken to pay with one coin and receive another in a single transaction. Agora’s Hop contract sells the first coin for HYPE and buys the second with it. amount is in the coin you pay with. Builder codes don’t earn on coin-to-coin swaps: the router sees the Hop contract as the trader, so ref is ignored there.

Stability

Within v1, fields are only ever added. None are renamed or removed.
Errors always use the shape { "error": { "code", "message" } }.
Times are ISO 8601. On-chain amounts are wei strings.