---
name: trnch
description: Trade new Robinhood Chain tokens through TRNCH, a non-custodial trading terminal. Live Heat feed of screened launches, best route across six routers, rugs and honeypots refused by TIA. 0.5% fee.
---

# TRNCH for AI agents

TRNCH (https://trnch.fun) is a non-custodial trading terminal on Robinhood Chain (chainId 4663).

- **The Heat**: new tokens, ranked live a few seconds after their pool is created.
- **TIA (Trnch Intelligence Agency)**: screens every launch before it reaches the feed. Rugs, honeypots, scam contracts, heavy sell taxes and copycats are kept out, and the API refuses to trade them.
- **Best route**: each swap is quoted across six routers (KyberSwap, LI.FI, Uniswap, 0x, SushiSwap, 1inch). The best return comes back as a transaction your wallet signs. TRNCH never holds funds or keys.
- **Fee**: 0.5% per swap, already deducted from the amounts returned.

Live numbers, no key: `GET https://trnch.fun/api/bot/v1/stats` (tokens spotted, kept out as High risk, rugs detected, median detection delay).

## Network

- Chain: Robinhood Chain, chainId `4663`, native gas token ETH
- Public RPC: `https://rpc.mainnet.chain.robinhood.com`
- USDG (Global Dollar, 6 decimals): `0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`
- Explorer: https://robinhoodchain.blockscout.com

## Connect

- **MCP**: `https://trnch.fun/api/mcp` (streamable HTTP, JSON). Tools: `trnch_stats`, `trnch_register_message`, `trnch_register`, `trnch_heat`, `trnch_quote`, `trnch_buy`, `trnch_sell`, `trnch_confirm`.
- **REST**: base `https://trnch.fun/api/bot/v1`, OpenAPI spec at `https://trnch.fun/openapi.json`. Send the header `Authorization: Bearer trnch_bot_...` on every call except `/stats` and `/register`.

## Get a key (no browser)

1. Call `GET /register?wallet=0xYourWallet`. It returns `message`.
2. Sign `message` with that wallet using `personal_sign` (EIP-191). No funds move.
3. Call `POST /register` with `{ "wallet": "0x...", "message": "...", "signature": "0x..." }`. It returns `key`, which is shown once.

The wallet needs 10 USDG or 0.004 ETH on Robinhood Chain. Up to 3 keys per wallet.

Building an agent that other people run? Add `"ref": "<your referral code>"` to `POST /register`: every swap made with that key pays you 25% of the TRNCH fee, for life. Your code is in your TRNCH profile (Invite).

## Trade

1. **Read the Heat**: `GET /heat`.
   - `heat` holds screened tokens; `new` holds just-spotted tokens (higher risk).
   - Each token is an opaque `id` with market numbers: rank, Heat score, price, liquidity, volume, price changes and entry time.
   - Pass `nextSince` back as `since` to get only new entries. Dedupe by `id`.
2. **Buy**: `POST /buy` with `{ "tokenId": "<id>", "amountUsd": 25 }`, paid in USDG.
3. **Sell**: `POST /sell` with `{ "tokenId": "<id>", "percent": 100 }`.
4. **Sign and send**: both return `{ router, quote, approval, tx, chainId }`.
   - If `approval` is present, send it first.
   - Then send `tx` from your wallet.
5. **Optional**: `POST /confirm` with `{ "txHash": "0x..." }` credits the volume to your TRNCH account.

## Limits

- 60 calls per minute per key, 30 of which can be quotes, buys or sells.
- Building more than 8 swaps without sending any transaction pauses building for that wallet for up to 24 hours.
- A token TRNCH refuses returns 409 `token not tradable through TRNCH`.

Use of TRNCH data is limited to trading through TRNCH (https://docs.trnch.fun/legal/terms). Full documentation: https://trnch.fun/bot