Integrate eleos

What a terminal, a chart site, a bot or a registry needs to list and trade eleos coins. Everything here is live on Elysium, chain 99901. The reader side of the site is in the docs.

Addresses

Contract	Address
PoolManager Uniswap v4, our own deployment, every eleos pool lives here
EleosHook tax in HYPE, one hook for every HYPE coin, holds the locked liquidity
EleosLauncher Classic and Taxed coins
EleosLauncher (high start) the same launcher with the higher start price
EleosRouter swap and quote through the hook, also trades the v3 pools of Kleos and StockiumSwap
EleosBundler dev buy and team wallets inside the launch transaction
QuoteHook coins paired with KNTQ or USDC, tax in that token
QuoteLauncher KNTQ opens coins against KNTQ
QuoteLauncher USDC opens coins against USDC
QuoteRouter swaps on quote pools

RPC https://rpc.eleos.fun (relayed into the HyperEVM inbox until the public sequencer on Nov 9, gas on us), explorer elysiumexplore.com. The same list, kept current, as JSON: GET /api/idx/contracts (hooks, launchers, quote tokens).

Pool discovery

Every coin has exactly one pool on our PoolManager. HYPE coins trade native HYPE against the coin, fee 0, tickSpacing 200, hooks = EleosHook:

PoolKey { currency0: 0x0000000000000000000000000000000000000000, currency1: <token>, fee: 0, tickSpacing: 200, hooks: 0x8680965555DCEa2a4c0Ed3a29e59a8AA424E6acC }

Quote coins trade the quote token as currency0 against the coin, same fee and tickSpacing, hooks = QuoteHook. Quote tokens:

KNTQ18 decimals

USDC6 decimals

Find new coins by either event:

EleosLauncher.Launched(address indexed token, address indexed creator, PoolId indexed poolId, string name, string symbol, string meta, Config cfg, uint256 maxWallet, uint64 limitsUntil, uint256 devBuyHype, uint256 devBuyTokens, ...)
EleosHook.Opened(address indexed token, PoolId indexed id, Config cfg, int24 startTick, uint128 liquidity)

Swaps are the PoolManager's normal Swap event. Liquidity is full range and locked in the hook forever: no position NFT, nobody can pull it.

Trading through the hook

The hook takes the tax in HYPE inside beforeSwap and afterSwap (return delta), so any router that unlocks the PoolManager and settles native HYPE works. The simplest path is ours:

EleosRouter.buyV4(pm, key, minOut, to, deadline) payable          // HYPE in, coin out
EleosRouter.sellV4(pm, key, amountIn, minOut, to, deadline)       // coin in (approve first), HYPE out
EleosRouter.sellV4WithPermit(pm, key, amountIn, minOut, to, deadline, v, r, s)
EleosRouter.quoteV4(pm, key, buy, amountIn) -> out                // eth_call, reverts internally and returns the quote

Tax right now for a coin: EleosHook.taxNow(token) -> (buyBps, sellBps). Tax can only go down over a coin's life, never up. The first two minutes after launch may carry an anti-snipe extra, taxNow already includes it. Quote coins: the same calls on the QuoteRouter, amounts in the quote token.

Metadata and prices

Name, image, description and links are not on chain. Read them from our public index, no key, CORS open:

GET https://idx.eleos.fun/token/<address>
  -> { name, symbol, decimals, image, meta: { image, description, website, telegram, x }, creator, createdAt, launchTx,
       pool, price, mcap, holders, burned, burnedPct, liquidity, tax: { buy, sell }, quote, ... }
GET https://idx.eleos.fun/token/<address>/trades?limit=60
GET https://idx.eleos.fun/token/<address>/holders?limit=50
GET https://idx.eleos.fun/token/<address>/candles?tf=5m&metric=price
GET https://idx.eleos.fun/tokens?sort=new&limit=200

Images are served from https://eleos.fun/api/media/<file> (PNG, JPG, WebP, GIF). The meta string in the Launched event holds the same JSON the creator submitted. The routes also answer under https://eleos.fun/api/idx/.

Contact

Something missing for your integration? Write to us through the contact form or on X, @eleosfun. We add what you need.