常见问题

支持哪些平台？

BNB 链上的所有 Flap 代币和所有 four.meme 代币：内盘联合曲线上的，以及毕业后在发射平台迁移过去的 PancakeSwap 池子里的。你不用说明是哪一种，API 向两个平台询问、读取代币状态并选择场所。通过 API 发币在 Flap 上进行，普通币或税币都可以；four.meme 的发币在它自己的网站。

需要 API key 或账号吗？

不需要，所有接口都是开放的。每个 IP 有两个限制：单个接口每秒 3 次请求，以及最多 1 条发射推送连接。

我的私钥安全吗？

私钥永远不会离开你的机器。每个返回都是未签名的交易；签名在你的脚本里、用你的私钥完成，只有签好的交易字节会提交到 /api/send，它除了广播什么也做不了。私钥的任何信息都不会到达 shrine.trade，也不存在任何形式的托管。

要多少钱？

买入和卖出各收 0.5%，以结算资产计。其他一切（代币信息、发射推送、发币）免费。发射平台自己的内盘费用（Flap 1.25%，four.meme 1%）和代币的税另算，Gas 不到一分钱。见 费用。

amount 用什么单位？

买入时是 BNB，不管代币用什么计价，发射平台在途中把它换成 USDT、USD1 或代币用的任何资产。卖出时是代币数量，或余额的百分比如 "50%"。Flap 代币卖出得到 BNB；four.meme 代币卖出得到它的计价资产（BNB 计价的就是 BNB）。想直接用计价资产支付，持有它并加 payWithQuote；receiveQuote 让 Flap 卖出也以计价资产结算。

什么是税币？

创作者从每笔买卖里抽成的 Flap 代币，大多数新币都是。税已经在每个报价里（creatorTaxBps 是你这一边的税率），所以 expectedOut 就是你实际到手的数量。代币信息 能在交易前看到两个税率。

为什么买到的比我要的少？

这个代币限制单个钱包在内盘的买入量，而你到了上限。Flap 按上限成交，多出的部分在同一笔交易里退回。报价已经知道你剩余的额度，额度用完时会返回 buy_quota_exhausted。

交易有防夹子保护吗？

链上下限（minOut，由你的滑点得出）由 Flap 的合约强制执行，成交比报价差就直接失败，而不是以坏价成交。发币时的开发者买入在创建曲线的同一笔交易里执行，无法被狙击。BNB 链确实有公开内存池，但你不用碰它：签好的交易通过 /api/send 走我们自己的私有节点广播，而不是公共节点。

滑点是怎么回事？

slippage 是成交可以比报价差多少个百分点，超过就拒绝执行；API 把它换算成链上的 minOut。默认的 5 适合大多数内盘代币。火热的新币可能需要更高，安静的毕业币可以更低。slippage_exceeded 表示碰到了下限。

钱包余额够交易，为什么还报 insufficient_funds？

BNB 链节点在执行之前会先预留 gasLimit x maxFeePerGas，用不完的部分事后才退回。API 提前做同样的检查，并说明需要的确切余额。多留 0.002 BNB 就再也不会遇到这个问题。详见 Gas 与费用。

新币什么时候可以买？

Flap 上立刻就能买：它没有开盘狙击税，只有可选的单钱包买入上限和代币自身的税，两者都在报价里。four.meme 上，推送里标了 antiSniper 的发射会收取从高位逐块下降的交易费；轮询 代币信息 的 currentBuyFeeBps，回到 100（1%）再买，或者为抢先付这笔费。狙击教程 展示了一个读取发射事件、检查税率、然后买入的机器人。

实时推送真的免费吗？

是的。wss://api.shrine.trade/bnb/api/launches/ws 推送每一次 Flap 和 four.meme 发射和毕业。不需要密钥，每个 IP 一条连接。它是流，不是数据库：没有历史接口。

我的创作者收益在哪里？

Flap 会自动把税币的税打给它的受益人。/api/fees/{wallet}?token=YOUR_TOKEN 显示已经打了多少和还在等待的部分，/api/claim-fees 为等待中的部分构建交易。详见 创作者收益。

AI 编程工具能读这些文档吗？

可以，为此准备了两个文件：llms.txt 是每页一行的索引，llms-full.txt 是整站的纯文本。两者随每次发布重新生成。

去哪里求助？

到 Telegram 群 提问。新版本发布在 X。