ShrineAPI

Lightspeed

Raced over 8 lanes.
One fill.

Lightspeed builds your trade, signs it and sends it, in one request. On Developer and Professional it signs one copy per landing lane and fires them all at the same instant: the first to land fills, the rest fail before they move funds. On Lite it goes out over Shrine's staked lane.

Shrine's staked lane from Lite. All 8 lanes and the block 0 lane on Developer and Professional.

One buy, 8 lanesraced at once, Developerexample
  • Shrine SWQoS
  • Temporal
  • Jito
  • Astralane
  • bloXroute
  • Node1
  • FlashBlock
  • BlockRazor
The first copy to land fills; the rest revert.

01Speed

About 50 ms from request to landing.

On Lite every trade goes out on Shrine's own staked lane. Developer and Professional race all eight lanes and the block 0 lane at once, so the fastest path that slot wins.

~50msaverage landing round trip on Developer and Professional, raced over all 8 lanes
~100mson Lite, from request to landing through Shrine's own staked lane
8lanesSWQoS lanes raced at the same instant, with the block 0 lane beside them
~200msone Solana slot, for scale

02Provider racing

One request in. One fill out.

Each provider's path to the leader changes from slot to slot: its stake, its peering with that validator, its load. So a raced trade doesn't pick one. It goes to all of them at once, and a slow provider costs nothing, since its copy simply loses.

  1. 1Built once

    You send a token, an amount, slippage, a priority fee and a tip. The trade is built once, with nothing read from the chain on the way.

    one request
  2. 2Signed per lane

    One copy per provider, each with that provider's own tip account inside, so every copy has its own signature.

    ≈0.5 ms
  3. 3Fired together

    All copies leave our server in the same moment, in parallel, not one after another. The answer leaves on the first acceptance.

    t ≈ 1 ms
  4. 4First lands, the rest revert

    Whichever copy reaches the leader first executes. Every later copy fails on chain before it moves funds, and only the landed copy pays its tip.

    one fill
  • Send the trade.A token, an amount, slippage, a priority fee and a tip, with the wallet's ls_ key in x-api-key.
  • Pick the lanes.Without providers a trade races shrine and temporal. ["all"] races every provider the region has, and any other list races exactly the names you give.
  • One tip, paid once.tip is per copy, and only the landed copy pays it, so a higher tip is not multiplied by the number of providers.
  • Watch every signature.submissions lists each provider with its signature, whether it accepted and its ms. Any accepted copy may be the one that landed, so watch every signature, or simply the wallet's balance.
  • Losing copies for free.With nonce: true every copy uses the wallet's durable nonce. The first to run uses it up; the others are dropped before they execute and cost nothing, not even their priority fee.
A raced buyJavaScriptfrom the docs
const res = await fetch("https://sol.shrine.trade/api/lightspeed", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "ls_…",  // a dashboard wallet's key
  },
  body: JSON.stringify({
    action: "buy",         // "buy" or "sell"
    mint: "<token mint>",
    amount: 0.5,           // SOL on a buy; tokens or "100%" on a sell
    slippage: 25,          // percent; snipes want room
    priorityFee: 0.002,    // SOL, total
    tip: 0.001,            // SOL per copy; only the landed copy pays
    // Developer, Professional: the lanes that race (omit for
    // these two, ["all"] for every one). Lite: shrine only.
    providers: ["shrine", "temporal"],
  }),
});
const r = await res.json();
console.log(r.success, r.signature, r.submissions);
{
  "success": true,
  "signature": "3nQ…",
  "submissions": [
    { "provider": "temporal", "signature": "3nQ…",
      "accepted": true, "ms": 9.1, "sentUs": 98 },
    { "provider": "shrine", "signature": "4Rc…",
      "accepted": true, "ms": 11.7, "sentUs": 124 }
  ],
  "tipLamports": 1000000,
  "slot": 447483508,
  "guard": true,
  "buildMs": 0.07
}

03Two wallets

Your bot's wallet, or one only your key opens.

A trade goes out from one of two wallets. Both get the same race, on the lanes your plan has, in every region your plan has.

On the dashboard

A Lightspeed wallet

A wallet only your API key opens. Its private key is encrypted under its ls_ key, and without that key nobody, including us, can open the wallet.

  • Up to 10 per account, each with its own ls_ key
  • Trades with that key alone in x-api-key: the private key stays off the wire
  • Read its balance and withdraw SOL with no fee
  • The same key in every region your plan has: a bot moves by changing the address
Account docs

Your bot's own wallet

Your own key, for one trade

A bot that already holds its wallet sends your plan's key in x-api-key and the wallet's privateKey in the body, and gets the same race.

  • The key signs that one trade and is dropped
  • Nothing is stored, nothing is logged
  • A Lightspeed wallet that is not on your account works the same way, by its ls_ key as apiKey
  • A durable nonce too: the nonce requests take privateKey in the body
Trade docs

04Block 0 lane

Landed in the slot it was sent for.

Solana hands the block to a new leader every 4 slots, and those leaders sit all over the world. The block 0 lane is one more copy in the race, sent only when the leader is close to our region and its slot has just started.

  • Leader near: sent.The copy goes out the instant the slot starts, reaches the leader before it seals the block, and is usually first.
  • Leader far: held.The copy never reaches the network and costs nothing. The other lanes carry the trade as usual.
  • No tip.Its copy goes out as built, whatever tip says, so when it lands first the tip stays in your wallet.
  • Close to the API.Run your bot in the same region, or on a private link, so the request reaches the race while the slot is still young.
Add the block 0 laneJavaScriptfrom the docs
body: JSON.stringify({
  action: "buy",
  mint: "<token mint>",
  amount: 0.5,
  slippage: 25,
  priorityFee: 0.002,
  tip: 0.001,
  // or ["all"]: block0 is in it on Developer and Professional
  providers: ["shrine", "temporal", "block0"],
}),
  • Leader ANear: sent
  • Leader BFar: held
  • Leader CNear: sent
  • Leader DFar: held
An example schedule. A held copy still shows as accepted in the response: check the landed signature.

05Plans

From Lite. Raced from Developer.

Lightspeed comes with Lite, Developer and Professional, which trade at 0%. Tips you set go to the landing provider, not to us.

FreeLiteDeveloperProfessional
Shrine staked lane, ~100 ms–3 req/s, 0%10 req/s, 0%10 req/s, 0%
Provider racing: all 8 SWQoS lanes, ~50 ms––10 req/s, 0%10 req/s, 0%
Block 0 lane––✓✓
Every regionFrankfurt, Amsterdam and New York–Frankfurt✓✓
Private link––✓✓

Every limit, endpoint by endpoint, is in Plans and limits. Prices are on the pricing page. A new account can try Developer free for 5 hours, from the dashboard.

06FAQ

Questions, answered.

Anything else is in the Lightspeed docs.

How fast does a Lightspeed trade land?

About 100 ms from request to landing on Lite, over Shrine's staked lane. About 50 ms on Developer and Professional, where the same request goes out on all 8 SWQoS lanes and the block 0 lane at the same instant.

Can a raced trade fill twice?

No. Every copy carries the same trade and has its own signature. The first to execute trades; the rest fail on chain before they move funds. A failed copy costs its priority fee and nothing else: the tip is inside the same transaction and fails with it. So the tip is paid once, to the provider whose copy landed.

Which lanes race, and how big a tip do they need?

Without providers a trade races Shrine's staked RPC, which takes no tip, and Temporal. ["all"] races every provider the region has, and a list such as ["temporal", "jito", "astralane"] races exactly those. A provider whose minimum is above your tip is left out: the default 0.001 SOL reaches all of them but Node1, and 0.002 reaches all. GET /api/lightspeed/providers lists the region's providers and their minimums.

What is the block 0 lane?

A copy that goes out only when the current leader is close to our region and its slot has just started, so it lands in the slot it was sent for. When the leader is far, the copy is held back: it never reaches the network and costs nothing. It takes no tip. Add block0 to providers on Developer or Professional; ["all"] includes it too.

Do I have to send my private key?

No. A wallet made on the dashboard trades with its ls_ key alone: its private key is encrypted under that key, and without it nobody, including us, can open the wallet. If your bot already holds its wallet, send your plan's key in x-api-key and privateKey in the body. It signs that one trade and is dropped; nothing is stored.

Lightspeed comes with Lite, Developer and Professional, at 0% per trade.