跳到主要内容
Lite属于 Lite 套餐,Developer 套餐也包含。 查看套餐 · 获取密钥

账户

Lightspeed 钱包是我们替你托管的钱包,用它的 ls_ 密钥加密。只凭这把密钥就能交易,按它所属账户的套餐运行。

在控制台上​

控制台是管理这些钱包最简单的地方:

  • 创建钱包。 每个账户最多 10 个。它的地址、ls_ 密钥和私钥只显示一次:请保存好。
  • 全部一览。 每个钱包的名称、它在 Solscan 上的地址和它的 SOL。
  • 关联已有的钱包。 粘贴它的 ls_ 密钥,它就加入你的账户,按你的套餐交易。
  • 移除钱包。 它离开你的账户,保留它的密钥和 SOL;关联到一个有套餐的账户后,或在 x-api-key 里带上某个套餐的密钥时,它就能再次交易。

在这里​

下面的表单无需账户即可创建钱包。之后在控制台上关联它,它就按你的套餐交易。

1Create a Lightspeed account

Generates a wallet on the server, encrypted under the API key you get back. Nothing is stored in your browser.

2Your API key

Filled in after creating an account, or paste one here. Kept only while this page is open.

3Balance

用代码操作​

两个请求:创建账户(无请求体),然后把密钥放在 x-api-key 头里查询余额。

curl -X POST https://sol.shrine.trade/api/lightspeed/account
curl https://sol.shrine.trade/api/lightspeed/account -H "x-api-key: ls_…"

要在不导入私钥的情况下把 SOL 转出,向 POST /api/lightspeed/withdraw 发送 to 和 amount("100%" 表示网络费之外的全部),请求头相同。

想让所有服务商一起竞速、又不为落败的副本付费,就为钱包创建一次 nonce 账户:见 Nonce 账户。

创建接口的响应是 { "pubkey", "api_key", "private_key" },只显示一次。向 pubkey 充入 SOL(再多留一点用于小费和手续费);若币以 USDC 或其他代币计价,也要充入相应的计价代币。

:::caution 你的钱包,你的密钥 API 密钥就是钱包的钥匙。谁持有它或私钥,谁就控制着资金;我们无法找回丢失的 API 密钥,所以请把私钥留作备份。钱包里只放狙击要用的钱,及时提取利润,并把两者都当作密码对待。任何一个泄露,就创建一个新账户并把余额转走。 :::

余额​

curl https://sol.shrine.trade/api/lightspeed/account -H "x-api-key: ls_…"
{ "pubkey": "5Vk…nq2", "sol": 1.204, "lamports": 1204000000, "tokens": [ { "mint": "…", "amount": 1250000, "amount_raw": "1250000000000", "decimals": 6 } ] }

提现​

把 SOL 转出,不收费。amount 为 SOL 数量,或 "100%" 表示网络费之外的全部。

curl -X POST https://sol.shrine.trade/api/lightspeed/withdraw \
-H "content-type: application/json" \
-d '{ "apiKey": "ls_…", "to": "<your wallet>", "amount": "100%" }'

Nonce 账户​

交易带上 nonce: true 时,每个服务商的副本都使用钱包的持久 nonce:第一份执行的副本把它用掉,其余副本在执行前就被丢弃,不花任何费用,连优先费也不用(见交易页的"只成交一次,绝不两次")。nonce 存放在 nonce 账户里,每个钱包一个,地址由钱包推导而来,只有钱包本身能控制它。账户里存着约 0.001 SOL 的租金,从钱包支付;关闭账户时退回。

用钱包的密钥创建一次:

curl -X POST https://sol.shrine.trade/api/lightspeed/nonce -H "x-api-key: ls_…"
{ "wallet": "5Vk…nq2", "address": "9Qe…7Lm", "exists": true, "nonce": "6Hr…uYw", "sol": 0.00105664, "changed": true, "signature": "3xT…" }

账户确认后才返回响应,大约一两秒。此后在交易里发送 "nonce": true 即可。再次调用不会新建任何东西,只会返回钱包已有的账户(changed: false)。

字段
walletstring账户所属的钱包。
addressstringnonce 账户地址。
existsboolean账户现在是否存在。
noncestring当前的 nonce 值。
solnumber账户里的 SOL。DELETE 时为退回钱包的数量。
changedboolean本次调用创建了账户(POST)或关闭了账户(DELETE)。
signaturestring完成这一操作的交易。

用 GET 加同样的请求头查看。用 DELETE 关闭:账户里的 SOL 退回钱包。有交易正在使用 nonce 时会拒绝关闭,几秒后再试。withdraw 的 "100%" 不包括 nonce 账户里的 SOL,要全部转出,先关闭该账户。

curl https://sol.shrine.trade/api/lightspeed/nonce -H "x-api-key: ls_…"
curl -X DELETE https://sol.shrine.trade/api/lightspeed/nonce -H "x-api-key: ls_…"

使用你自己的钱包时,POST 和 DELETE 在 JSON 请求体里带上 privateKey,并在 x-api-key 里放套餐密钥,与交易相同。

如果跳过这一步,钱包的第一笔 nonce: true 交易会自己创建账户,在此期间按常规方式竞速;它的响应会显示 "nonce": "preparing"。