# Pons Trading API

> Trade and launch tokens on Pons, on Robinhood Chain

shrine.trade's free, keyless HTTP + WebSocket API for Pons - the launchpad on Robinhood Chain (chain id 4663, an Ethereum L2). Buy and sell any Pons token: v2 (bonding curve, then Uniswap v4 after graduation) or v1 (Uniswap V3 from launch). Launch new tokens on Pons v2. Every endpoint returns unsigned EIP-1559 transactions the caller signs and sends themselves; the API never holds keys or funds.

Key facts:

- Base URL: https://api.shrine.trade/rh (WebSocket: wss://api.shrine.trade/rh/api/launches/ws)
- Auth: none. Limits: 5 requests/second per IP per endpoint, 2 launch-feed connections per IP (HTTP 429 beyond).
- Amounts on a buy are always ETH; tokens priced in USDG, NVDA, TSLA or another tokenised asset are converted automatically. Sells can convert back to ETH with `toEth: true`.
- Fee: 1% per trade to shrine.trade, taken in the asset the trade settles in. Launching and reads are free. Pons's own curve fee, creator tax and opening snipe tax apply on top.
- Responses carry `txs`: sign each with the wallet in `from` and POST the signed hex to /api/send as `{ "signedTx" }`, in order - no RPC needed. Errors are `{ "error": code, "message": text }`.
- Full text of every page: https://shrine.trade/pons/llms-full.txt

## Docs

- [Pons API for Trading Bots on Robinhood Chain](https://shrine.trade/pons/index.md): Build bots that trade and launch tokens on Pons and Uniswap on Robinhood Chain through one free, keyless API. Buy, sell, stream every launch live, create tokens, claim creator fees.
- [Pons Trade Stream: Every Buy, Sell and Liquidity Change on Robinhood Chain](https://shrine.trade/pons/advanced-stream.md): WebSocket stream of every buy, sell, liquidity add and liquidity removal for the Pons tokens you choose, on the bonding curve, in Uniswap v4 after graduation, and in Uniswap V3. Free key, live.
- [Create a Token on Pons (Robinhood Chain)](https://shrine.trade/pons/create-token.md): Launch a token on the Pons v2 bonding curve on Robinhood Chain with one signed transaction - metadata, image, creator tax, dev buy and any quote asset from ETH to NVDA.
- [Claim Pons Creator Fees](https://shrine.trade/pons/creator-fees.md): See what your Pons launches have earned on Robinhood Chain and claim it to your wallet in two calls.
- [API Errors](https://shrine.trade/pons/errors.md): Every error code the Pons Trading API returns, grouped by endpoint, with what to do about each.
- [Frequently Asked Questions](https://shrine.trade/pons/faq.md): Answers about supported platforms, fees, private-key safety, amounts, slippage, the live feed and rate limits for the Pons Trading API.
- [Fees](https://shrine.trade/pons/fees.md): shrine.trade charges 0.5% per trade on Pons and Uniswap v4 tokens on Robinhood Chain; launching and reading are free. Pons fees and the opening snipe tax apply on top.
- [Live Pons Launches on Robinhood Chain](https://shrine.trade/pons/live-launches.md): WebSocket feed of every new Pons launch, every graduation and every new Uniswap v4 pool on Robinhood Chain, the moment it happens. Free and keyless.
- [Buy & Sell Pons Tokens on Robinhood Chain](https://shrine.trade/pons/local-trade.md): Buy or sell any Pons v2 token on Robinhood Chain with one script, on the bonding curve or on Uniswap v4. Pay in ETH; tokens priced in USDG, NVDA or TSLA are converted for you.
- [Pons Token Info API](https://shrine.trade/pons/token-info.md): Read any Pons token on Robinhood Chain: curve reserves, graduation phase, snipe tax for your wallet and unswept creator fees.
- [Robinhood Chain Gas and Fees Explained](https://shrine.trade/pons/tutorials/robinhood-chain-gas-and-fees.md): What ETH on Robinhood Chain is, how to get it, what a trade or a launch actually costs, and why the wallet needs more than the trade amount.
- [How to Snipe Pons Launches on Robinhood Chain](https://shrine.trade/pons/tutorials/snipe-pons-launches.md): A complete Node.js bot that watches the Pons launch feed, waits out the snipe tax, buys new tokens with ETH and sells at a target or a stop.
- [Trade Tokens Priced in NVDA, TSLA or USDG with ETH](https://shrine.trade/pons/tutorials/trade-tokenised-stocks.md): How Pons tokens priced in tokenised stocks work on Robinhood Chain, and how to buy and sell them holding nothing but ETH.