常见问题
支持哪些平台?
BNB 链上的所有 Flap 代币:内盘联合曲线上的,以及毕业后在 Flap 迁移过去的 PancakeSwap 池子里的。你不用说明是哪一种,API 从 Flap 读取代币状态并选择场所。发币在 Flap 上进行,普通币或税币都可以。
需要 API key 或账号吗?
不需要,所有接口都是开放的。每个 IP 有两个限制:单个接口每秒 3 次请求,以及最多 1 条发射推送连接。
我的私钥安全吗?
私钥永远不会离开你的机器。每个返回都是未签名的交易;签名在你的脚本里、用你的私钥完成,只有签好的交易字节会提交到 /api/send,它除了广播什么也做不了。私钥的任何信息都不会到达 shrine.trade,也不存在任何形式的托管。
要多少钱?
买入和卖出各收 0.5% 的费用,以结算资产计。其他一切,代币信息、发射推送、创建代币,都免费。Flap 自己的内盘费用和代币的税另算,Gas 不到一分钱。详见 费用。
amount 用什么单位?
买入时是 BNB,不管代币用什么计价;Flap 会在交易内把它换成 USD1 或代币使用的任何资产。卖出时是代币数量,或余额百分比如 "50%";收益以 BNB 返回。只有 Flap 无法兑换时,计价资产本身才需要出场(payWithQuote、receiveQuote)。
什么是税币?
创作者从每笔买卖里抽成的 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 没有开盘狙击税;它有的是可选的单钱包买入上限和代币自身的税,两者都在报价里。狙击教程 展示了一个读取发射事件、检查税率、然后买入的机器人。
实时推送真的免费吗?
是的。wss://api.shrine.trade/bnb/api/launches/ws 推送每一次 Flap 发射和毕业。不需要密钥,每个 IP 一条连接。它是流,不是数据库:没有历史接口。
我的创作者收益在哪里?
Flap 会自动把税币的税打给它的受益人。/api/fees/{wallet}?token=YOUR_TOKEN 显示已经打了多少和还在等待的部分,/api/claim-fees 为等待中的部分构建交易。详见 创作者收益。
AI 编程工具能读这些文档吗?
可以,为此准备了两个文件:llms.txt 是每页一行的索引,llms-full.txt 是整站的纯文本。两者随每次发布重新生成。
去哪里求助?
到 Telegram 群 提问。新版本发布在 X。