Trnch on Elysium

Build a buy in one call: quotes three routers and returns the best route as a transaction for the key's wallet to sign. Give token, and amountUsd (paid in USDC) or amountIn with tokenIn (the zero address pays in HYPE). The Trnch fee is already deducted from the quote; the rate applied is returned as feeBps. Returns { router, feeBps, quote, approval, tx, chainId, from }: approval, when not null, has to be sent before tx, from the same wallet (chainId 99901). Nothing is sent by Trnch. Errors: 503 while the fee recipient is not configured on this chain (nothing is built), 404 no route, 429 rate or build limit (retry-after). Requires an API key (created by wallet signature), sent as Authorization: Bearer <key>.

Read on-chain facts about any Elysium token before you trade it. Returns { token, chainId, screened: false, sellTest, hookFee, liquidity, creator, launchpad, template, forcedTransfer, meaning }: sellTest { class, result, blockedAt, complete, variantsRun, variantsSkipped, lossPct, method, sizes [{ amount, result, lossPct }], extraLossPctAtLargerSize, buyTaxPct, transfer { ok, backOk, taxPct }, sellLossPct, logsMatchBalances, delayed { clockAdvancedMinutes, result }, note }: a simulation at the time of the read that tries to buy, approve, transfer wallet to wallet and back, and sell from both wallets, as separate transactions, through the pools Trnch would route through (the proven launch pool, the deepest and the oldest qualifying pool; the worst result decides: decidingPool, poolTested, checkedAt), at two sizes and again with the clock advanced 5 minutes in simulation; note says in words what actually ran, complete, variantsRun and variantsSkipped say what did not and why, and a partial result reads "(partial check)"; class sold (bought, transferred and sold in a simulation, every step that ran succeeded), taxed, blocked (blockedAt says whether the approval or the sell failed in the simulation), transfer-failed (the tokens could not be moved between wallets in the simulation) or not-checked; buy tax, transfer tax and sell loss are reported apart, and token logs that do not match balances are reported. A simulation now: the token may behave differently later or towards other wallets, and an upgradeable or owner-controlled token can change; sizes 0.25 HYPE and, when the pool is deep enough, 1.5 HYPE; poolTested { id, feeBps, hook, launchpad, poolThinForSize, depthLowerBound }; decidingPool { id, roles, why }; poolsTested; poolsTruncated; checkedAt; hookFee { buyBps, sellBps } when the pool has a launch hook; liquidity { found, usdEstimate }; creator { launches }: how many tokens the same creator launched before this one; launchpad { result, hook, proof }: the launchpad of the pool tested, named only when proven ("Montra", "Boxa", "Kleos"; a verified contract name alone reads "<Name> (contract name)"), otherwise "hook not identified" or "no hook", a fact about origin, never a signal by itself; hookRisk { result }: what the hook of that pool can take, read on chain where readable: "launch fee window: up to N%, ends in M min", "hook tax: N% buy, M% sell" or "hook can tax up to N%", null when there is nothing to say; template { result, implementation, upgradeable }: "Montra template" when the token is a clone of that launchpad's token, "clone, template not identified", "upgradeable proxy" (its code can be replaced after the read) or "custom contract"; forcedTransfer { result, rolesTried, callsTried }: whether the declared owner or the creator could move or burn a buyer's tokens without approval in a simulation, trying only transferFrom without allowance and burn (other owner powers are not tried), "none found", "found: <reason>" or "not checked: <why>". A fact that could not be read says "not checked: <why>". Facts, not a verdict: Trnch runs no rug screen on this chain. No key needed.

Optional, after sending a swap built by trnch_buy or trnch_sell on Elysium (chainId 99901): report its hash. Returns { ok, txHash, chainId, status: "pending", meaning }, an acknowledgement only: it does not send, cancel or change the transaction. Nothing is credited on the call. A scheduled pass (every 2 minutes) reads the transaction on Elysium: sent by the key's wallet, a swap Trnch built for it, and the Trnch fee paid to the Trnch fee recipient in that same transaction. Only then is its volume counted in the swap stats of Elysium; there are no points or rewards on this chain. A hash that does not prove all of this counts nothing. Calling it twice with the same hash changes nothing. 10 calls per minute per key; 20 hashes at most awaiting settlement per wallet (429). 409 if the wallet has no Trnch account (sign in once on the site). Requires an API key (created by wallet signature), sent as Authorization: Bearer <key>.

Quote any pair on Elysium across three routers (Uniswap, KyberSwap and LI.FI) without building a transaction. Returns the best amount out, already net of the Trnch fee, the router and the fee rate in basis points (feeBps). Native HYPE is the zero address. No API key needed for a quote; a transaction (trnch_buy, trnch_sell) needs one.

Step 2 of 2: send the message returned in step 1 and its signature; returns { key, prefix, wallet } with status 201. The key is shown once, store it. The wallet must hold 10 USDC or 0.15 HYPE on Elysium (402 otherwise); 3 keys max per wallet (409); 400 if the signature or message does not match.

Step 1 of 2 to get an API key, no browser. Returns { message }: the exact text your wallet must sign with personal_sign (EIP-191). It is valid for 10 minutes and moves no funds.

List the tokens a Elysium wallet holds in one call. Returns { wallet, truncated, partial, checked, tokens }: each token has address, symbol, name, balance { raw, decimals }, valueUsd when known, majorAsset, factsStatus and facts { sellTest, hookFee, liquidity, creator, launchpad, template, forcedTransfer } as in trnch_check, read for the 8 largest holdings that are not HYPE, WHYPE or USDC (others: factsStatus over_limit, call trnch_check). At most 100 tokens, largest first. Cached 60 s per wallet. Facts, not a verdict: Trnch runs no rug screen on this chain. No key needed.

Build a sell for USDC in one call: give token, and percent of the wallet balance (read on chain) or an exact amount. Quotes three routers and returns the best route as a transaction to sign. The Trnch fee is already deducted from the quote; the rate applied is returned as feeBps. Returns { router, feeBps, quote, approval, tx, chainId, from }: approval, when not null, has to be sent before tx, from the same wallet (chainId 99901). Nothing is sent by Trnch. Errors: 503 while the fee recipient is not configured on this chain (nothing is built), 404 no route, 429 rate or build limit (retry-after). Requires an API key (created by wallet signature), sent as Authorization: Bearer <key>.

Read the facts of Trnch on Elysium: chainId 99901, gas HYPE, reference stable USDC, the three routers (Uniswap, KyberSwap and LI.FI), the bot fee grid in percent, and activity { windows [{ window (24h, 7d, 30d), volumeUsd, swaps, traders }] } counted from swaps made through Trnch on this chain (null while hidden or unavailable). No Heat and no rug counts: Trnch runs no rug screen on this chain. No key needed.

The tokens of the Elysium pools with the most trading volume over the last 24 hours, in the order GeckoTerminal lists them (the Top volume list of Trade on Trnch), with a link to trade each. HYPE, WHYPE and USDC are left out. Returns { tokens [{ rank, address, symbol, name, logoUrl, trade }] }, no volume figures. A volume ranking, not a screen, a verdict or a recommendation: Trnch runs no rug screen on this chain. No key needed.