套餐与限额
三个套餐。Free 不需要密钥，也不需要账户：马上就能交易、发币、转移代币和读取实时数据，每笔交易 0.25%。Lite 和 Developer 按月订阅，用 SOL 支付，交易费降到 0%。在价格页面并排比较它们，并在控制台开通套餐。
| Free | Lite | Developer | |
|---|---|---|---|
| 价格 | 免费 | 查看价格 | 查看价格 |
| 交易费 | 0.25% | 0% | 0% |
| API 密钥 | 不需要 | 有 | 有 |
这些套餐只针对 Solana。BNB Chain、Robinhood Chain 和 Arc 的 API 仍然免费使用，按笔收取交易费，没有订阅。
密钥
Free 上的一切都无需密钥即可使用，只有实时 K 线例外：它需要到 Telegram 群申请一个免费密钥。其他地方密钥是可选的：带上你套餐的密钥，同一个请求就按你套餐的限额运行，费率 0%。付费功能需要它。
每个账户一把密钥，有了套餐之后在控制台获取。每个请求都带上它：
- REST：
x-api-key请求头。 - WebSocket（Socket.IO）： 握手中的
auth: { api_key }。 - Ultra Fast Shred Stream： URL 上的
?key=，或x-api-key请求头。
// REST
await fetch("https://sol.shrine.trade/api/local-trade", {
method: "POST",
headers: { "content-type": "application/json", "x-api-key": "sk_…" },
body: JSON.stringify({ /* … */ }),
});
// WebSocket
const socket = io("https://sol.shrine.trade", { auth: { api_key: "sk_…" } });
保管好它：任何拿到这把密钥的人都在用你的套餐。在控制台生成一把新密钥，旧的就会失效。
交易
| Free | Lite | Developer | |
|---|---|---|---|
| 本地交易 API | 3 次/秒，0.25% | 3 次/秒，0% | 10 次/秒，0% |
| 创建代币 | 1 次/秒 | 3 次/秒 | 5 次/秒 |
| 领取创建者费用 | 1 次/秒 | 5 次/秒 | 10 次/秒 |
| 钱包工具 | 1 次/秒 | 3 次/秒 | 10 次/秒 |
| Jito 捆绑包 | – | 1 次/秒 | 10 次/秒 |
| 多操作交易 | – | 3 次/秒 | 10 次/秒 |
发币免费；它的开发者买入是一笔交易，按套餐的交易费率付费。
Lightspeed
| Free | Lite | Developer | |
|---|---|---|---|
| Shrine 质押通道，约 100 ms | – | 3 次/秒，0% | 10 次/秒，0% |
| 多服务商竞速：全部 8 条 SWQoS 通道，约 50 ms | – | – | 10 次/秒，0% |
| 0 区块通道 | – | – | ✓ |
你设定的小费归落地服务商，不归我们。交易从控制台上创建的钱包发出（它的 ls_ 密钥放在 x-api-key 里），或从你自己的钱包发出：你套餐的密钥放在 x-api-key 里，钱包的 privateKey 放在请求体里。见交易。
数据
| Free | Lite | Developer | |
|---|---|---|---|
| 元数据 | 1 次/秒 | 5 次/秒 | 20 次/秒 |
| SOL 价格 | 1 次/秒 | 10 次/秒 | 20 次/秒 |
| 价格、交易、SOL 价格、新币和迁移数据流 | 2 个 socket | 5 个 socket | 50 个 socket |
| 实时 K 线 | 1 个代币，1 个 socket，Telegram 免费密钥 | 所有代币，3 个 socket | 所有代币，10 个 socket |
| 历史 K 线 | 每分钟 1 次 | 每秒 1 次 | 每秒 5 次 |
| Advanced Data Stream（高级数据流） | – | 2 个 socket | 5 个 socket |
| 24 小时回放 | – | 1 个 socket | 3 个 socket |
| Ultra Fast Shred Stream（超快分片流） | – | – | 3 个 socket |
| 按小时归档 | ✓ | ✓ | ✓ |
仅限 Developer
达到限额时
每次拒绝都是 JSON：被拒绝的是什么、所在的套餐，以及去哪里看套餐。
// 403：不在你的套餐里
{ "error": "plan_required", "plan": "lite", "message": "Jito bundles come with Lite and Developer", "upgrade": "https://shrine.trade/api/pricing/" }
// 429：超出你套餐的速率（同时带 Retry-After 响应头）
{ "error": "rate_limited", "plan": "free", "message": "3 requests a second on this endpoint on Free - slow down and retry", "retryAfterMs": 1000, "upgrade": "https://shrine.trade/api/pricing/" }
// WebSocket ack：你的套餐为这条流允许的 socket 都已占用
{ "error": "limit_exceeded", "plan": "lite", "message": "…", "upgrade": "https://shrine.trade/api/pricing/" }
plan： 在plan_required上，是包含它的最便宜的套餐；其他情况下，是你当前的套餐。upgrade： 价格页面；Developer 上不带此字段。401 unknown_key/key_disabled： 这把密钥不是我们发的，或已被一把新密钥取代。不带密钥即可使用 Free。
付款
在控制台上：用 Phantom 或 Telegram 登录，选一个套餐，用 SOL 支付。付款一到账套餐就开始，有效期一个自然月；再付一次就再加一个月。如果你有折扣码，填在套餐下方的输入框里。