STYXN Elysium mainnet
⌘ K
DEVELOPERS

Integrate Styxn

Everything a terminal, aggregator or bot needs to recognize Styxn launches, show their logo and links, and trade them. No API key needed.

1. What a Styxn launch is

Every token launched on Styxn is a plain ERC-20 (1,000,000,000 supply, 18 decimals, no owner, taxes or blacklist) whose whole supply sits in one one-sided Uniswap V3 position in a standard pool on ElysPump's V3 factory, 1% fee tier, paired with WHYPE. If you index that factory you already see every Styxn pool and can trade it with any V3 router. The launchpad holds the position forever (there is no function to remove it) and splits its swap fees 50/50 between the creator and Styxn.

ChainElysium mainnet, chain id 99901
StyxPoolLaunchpad0xa5d26111D563831CbE437c77A1E519697C505A37
V3 factory (ElysPump)0x367F85886af509E364c8190862BC714555FeFc3e
Quote token (WHYPE)0xbA876237B0F021A6c6D852d6c26E107997cC5E81
Fee tier10000 (1%), tick spacing 200
SwapRouter / QuoterV20x10C2b8f290f90F373B9b86C14cdF532367D1a22e / 0x3e6158ef8ee2087b210a59939a1fff6d20c3dd7e

2. Recognize launches: the TokenLaunched event

The launchpad emits one event per launch, in the same transaction as the pool's PoolCreated. Index it to label pools as Styxn and to get the creator, name, symbol and metadata without extra calls.

event TokenLaunched(
  address indexed token,
  address indexed pool,
  address indexed creator,
  string name,
  string symbol,
  string meta,     // JSON, see below
  int24 tickLower,
  int24 tickUpper
)
topic0 = 0xbc6c385fe83940342930047f87eb87c8df4ad077819f1bf913b1adc18c0c9299
emitted by 0xa5d26111D563831CbE437c77A1E519697C505A37

Or read it on demand:

launches(address token) → (creator, createdAt, creatorShareBps, tickLower, tickUpper, pool)
tokensCount() → uint256        allTokens(uint256 i) → address

3. Metadata and images

The event's meta field is a JSON object; every field is optional.

{
  "image": "https://styxn.fun/api/img/<sha256>",
  "description": "…",
  "website": "https://…",
  "twitter": "handle",      // without @
  "telegram": "handle"      // t.me/<handle>
}

Images are content-addressed (the URL is the SHA-256 of the file), served with cache-control: immutable and open CORS, so you can embed or cache them as they are. The same data, already cleaned, is in GET /tokens/{address} (image and meta).

4. Public API

Base URL https://styxn.fun/api. JSON over HTTPS, CORS open to every origin. Please cache responses for a few seconds and keep to a few requests per second per client.

GET /pulse?pads=styxnNew, trending and top Styxn launches (drop ?pads for every Elysium launchpad)
GET /tokens/{address}Token profile: name, symbol, supply, holders, image, description and links, and its pools with price, market cap and liquidity
GET /tokens/{address}/holders?limit=50Largest holders with balance and share of supply
GET /pools/{pool}/trades?limit=100Latest trades with trader, side, amounts and USD value
GET /pools/{pool}/candles?res=60&limit=500OHLCV candles in USD; res is one of 1, 15, 60, 300, 900, 3600, 14400, 86400 seconds
GET /search?q={ticker|name|address}Search across every indexed Elysium token
WS /wsLive stream: send {"sub": ["pulse", "pool:0x…", "wallet:0x…"]} to get pool updates and trades as they happen
POST /rpcElysium JSON-RPC (chain 99901) with retries on the public node’s timeouts
curl https://styxn.fun/api/pulse?pads=styxn
curl https://styxn.fun/api/tokens/{address}

5. Bridge

StyxBridge on HyperEVM (chain 999) at 0x2C8EdA9715BB345e4F92529a0f8c76Df4956225D deposits HYPE into Elysium through its canonical Arbitrum Inbox, crediting the sender's address. It emits Deposited(sender, to, referrer, amountIn, credited, fee, referrerFee, ticketId).

Contact

Listing Styxn launches or want a feed we don't offer yet? Reach us on X @StyxnTerminal, or try the live launches.