Frequently asked questions
Which platforms are supported?
Every Pons token on Robinhood Chain - Pons v2 on its bonding curve and in its Uniswap v4 pool after graduation, Pons v1 in the Uniswap V3 pool it launched into - and any other token with a Uniswap pool here, such as the tokenised stocks (NVDA, TSLA, USDG …) themselves. One endpoint, the API works out where the token lives. Launching is Pons v2 only.
Do I need an API key or an account?
No. Every endpoint is open. The only limits are 3 requests per second per IP per endpoint, and one open socket per stream per IP: one launch feed and one data stream.
Is my private key safe?
It never leaves your machine. The API returns unsigned transactions; your script signs them with your own key and posts only the signed bytes to /api/send, which broadcasts them and can do nothing else with them. shrine.trade never sees the key, never holds funds, and cannot move anything on your behalf.
What does it cost?
0.5% of each buy and sell, taken in the asset the trade settles in. Reads, the live feed and launching are free. Pons's own curve fee, creator tax and opening snipe tax apply on top, and gas is a few cents. See Fees.
Which currency is amount in?
On a buy, always ETH, whatever the token is priced in - the API converts into USDG, NVDA or whichever asset the token uses. On a sell, tokens, or a percentage of your balance like "50%". Add toEth: true to a sell to receive ETH instead of the quote asset.
Why did my buy come back as three transactions?
The token is priced in a tokenised asset you didn't hold. The first transaction buys exactly the missing amount with ETH, the second is a one-time approval, the third is the buy. Send them in order; the script does. Next time it is one.
Are trades front-run protected?
Yes, in three ways. Robinhood Chain is an Arbitrum-based L2 with a single sequencer and no public mempool: your transaction is not visible to anyone before it is ordered, so there is nothing for a bot to jump ahead of. Every buy and sell carries a minimum (minOut, from your slippage) that the contract enforces, so a trade that would fill worse than quoted fails instead. And a dev buy on a launch runs inside the transaction that creates the curve, so it cannot be sniped. What remains is ordinary price movement between your quote and your transaction landing, which the slippage setting covers.
What is slippage and what should I set?
How far the price may move against you between the quote and the transaction landing, in percent. Default 5. Raise it on fast-moving tokens if you see slippage_exceeded; lower it on quiet ones. It is enforced on-chain, so a trade that would exceed it fails instead of filling badly.
Why is the wallet rejected when it holds enough for the trade?
Because the node reserves gas at the limit price before running the transaction. The API tells you the exact amount to hold. Keep 0.01 ETH extra and this never comes up. Details in gas and fees.
When can I buy a new launch?
Wait about five seconds. Pons taxes opening buys from near 99% down to zero. GET /api/token/{address}?recipient=YOUR_WALLET returns snipeTaxBps; buy when it is 0. The sniper tutorial does exactly that.
Can I get every trade, not just launches?
Yes. The Advanced Data Stream pushes every buy, sell, liquidity add and liquidity removal for the tokens you name, on the curve and in Uniswap after graduation. It needs a free key: join the Telegram group and ask. It is live and keeps no history.
Is the live feed really free?
Yes. wss://api.shrine.trade/rh/api/launches/ws streams every Pons launch, graduation and new Uniswap v4 pool. No key, one connection per IP. There is no history endpoint; it is a live feed.
Where are my creator fees?
They pile up on your token's curve until swept into Pons's escrow, then you claim them. /api/fees/{wallet}?token=YOUR_TOKEN shows both parts and /api/claim-fees builds the transactions. See Claim Creator Fees.
Can AI coding tools read these docs?
Yes. llms.txt is the index and llms-full.txt is every page as one text file, both regenerated on every release.
Where do I get help?
The Telegram group for support; releases are announced on X.