TRNCH

List the wallet alert subscriptions of this key: id, wallet, webhook URL, failures in a row, disabled flag and lastDelivery (delivered or failed). The secret is never returned again. Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Get a signed webhook POST when a token a wallet holds is newly flagged by Trnch. Give wallet (any address) and webhookUrl (https, a public domain name, port 443; IPs, localhost and private or internal names are refused). Each alert carries the token, the Trnch verdict { status, category, rugged, dumped }, canSell and the trnch_sell call to make. Checked every 5 minutes, one POST per token and subscription; tokens the wallet already holds that Trnch keeps out are sent once at the start (initial: true); a failed delivery is retried on the next run. Returns the subscription with a secret shown once: it signs every POST in X-TRNCH-Signature (t=,v1=). 3 subscriptions per key, 5 active per wallet, 20 per destination host (409); the same wallet again replaces its URL; 10 failed deliveries in a row disable it. Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Remove one wallet alert subscription of this key by id (from trnch_alerts_list). 404 if it does not exist. Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Build a buy in one call: quotes eight routers and returns the best route as a transaction for the key's wallet to sign. Give tokenId or token, and amountUsd (paid in USDG) or amountIn with tokenIn. The Trnch fee (0.25% standard, 0.10% between major assets, 0.50% for tokens under 24 h old or with no known launch time; the rate applied is returned as feeBps) is already deducted from the quote. Returns { router, feeBps, quote, approval, tx, chainId, from }: approval, when not null, has to be sent before tx, from the same wallet (chainId 4663). Nothing is sent by Trnch. Errors: 409 token not tradable through Trnch (kept out by Trnch), 429 rate or build limit (retry-after). Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Free, no key, no wallet: check any Robinhood Chain token before you buy it. Rug, honeypot, scam or copycat? Returns { status, category, rugged, dumped }: status kept_out (Trnch keeps it out of the Heat and will not trade it), in_heat, seen or unknown, with a public risk category (SCAM_CONTRACT, LINKED_TO_PAST_RUG, HEAVY_SELL_TAX, CANNOT_SELL, COORDINATED_LAUNCH, COPYCAT, LIQUIDITY_PULLED, DUMPED, OTHER_RISK; DUMPED is a coordinated dump, not a rug). unknown means not seen by Trnch, not a pass. Also returns creator { history, tokensInHeat } or null: launch history of the token's creator (bucketed), context only, not part of the verdict. Also returns builder { source, status (SHIPPING, ACTIVE, RESUMED, QUIET, DORMANT, UNKNOWN), verifiedBuilder, lastShipAt, ships30d, appliesToToken, measured, url, asOf } or null: what HEY Research reports about the team's shipping, per HEY, separate from the verdict; not a rating or a verdict (null when HEY has nothing; ships30d null means not measured; appliesToToken false means the activity is the project's). A signal, never a guarantee. Full record: https://trnch.fun/tia

Optional, after sending a swap transaction built by this server: report its hash so the volume is credited to the Trnch account of the key's wallet once the receipt is checked on chain. Returns an acknowledgement only; it does not send, cancel or change the transaction, and a hash that is not a swap of this wallet credits nothing. Calling it twice with the same hash changes nothing. Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Read the live Heat: heat holds tokens screened by Trnch and ranked by Heat score; new holds just-spotted tokens not yet screened (higher risk). Each token is an opaque id with rank, Heat score, price, liquidity, volume, price changes and entry time. Returns nextSince: pass it back as since to get only new entries, and dedupe by id. The feed refreshes every few seconds. Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Free, no key, no wallet: quote any pair across eight routers (KyberSwap, LI.FI, Uniswap, 0x, SushiSwap, 1inch, Velora, Nordstern) 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). Covers the official Stock Tokens of Robinhood Chain too. 409 if a token is not tradable through Trnch. A transaction (trnch_buy, trnch_sell) needs an API key.

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 USDG or 0.004 ETH on Robinhood Chain (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 for trading, 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.

Free, no key: check every ERC-20 a Robinhood Chain wallet holds in one call. Returns { wallet, truncated, checked, flaggedCount, tokens }: each token has address, symbol, balance { raw, decimals }, valueUsd when known, the same Trnch verdict as trnch_check { status, category, rugged, dumped }, creator (null when unknown; launch history of the token's creator, bucketed, context only, not part of the verdict), official (ETH, WETH, USDG and official assets are listed without a Trnch check), flagged, canSell (false only for a confirmed honeypot) and, for a flagged token that can be sold, a sell hint: the trnch_sell call to make and a trnch.fun/trade link. Flagged tokens come first. At most 100 non-official tokens are returned, flagged first, then tokens with no known price, then the most valuable (truncated: true when more are held). Cached 60 s per wallet. A signal, never a guarantee.

Build a sell for USDG in one call: give tokenId or token, and percent of the wallet balance (read on chain) or an exact amount. Quotes eight routers and returns the best route as a transaction to sign. The Trnch fee (0.25% standard, 0.10% between major assets, 0.50% for tokens under 24 h old or with no known launch time; the rate applied is returned as feeBps) is already deducted from the quote. Returns { router, feeBps, quote, approval, tx, chainId, from }: approval, when not null, has to be sent before tx, from the same wallet (chainId 4663). Nothing is sent by Trnch. Errors: 409 token not tradable through Trnch (kept out by Trnch), 429 rate or build limit (retry-after). Requires an API key (created by wallet signature), sent as Authorization: Bearer .

Free, no key: read live public numbers for the last 24 hours: tokens spotted, tokens in the Heat, tokens kept out as High risk, rugs detected, median detection delay in seconds, number of routers and the bot fee in percent.

Free, no key: what performed on Robinhood Chain in the last 24 hours: the best tokens that entered the Trnch Heat (new tokens screened by Trnch), with their peak and current multiple since entry, and a link to trade them at the best route. Rugged, dumped and flagged tokens are left out. Past performance, not a prediction.