Skip to main content

API Reference

SWQOS exposes two independent submission paths. Both require a tip-transfer instruction inside the submitted transaction; neither uses an API key.

HTTP / RPC endpoints​

Public endpoints — no authentication, no allowlist.

RegionURL
Frankfurthttps://fra-swqos.everstake.one
Amsterdamhttps://ams-swqos.everstake.one
New Yorkhttps://ny-swqos.everstake.one
Tokyohttps://tyo-swqos.everstake.one
Londonhttps://lon-swqos.everstake.one
Singaporehttps://sgp-swqos.everstake.one
Anycast (Cloudflare)https://main-swqos.everstake.one

Plain http:// is supported for HTTP/2 with prior knowledge (h2c) — useful for skipping the TLS handshake when latency matters.

Supported method​

Only one method is exposed:

  • sendTransaction — accepts a signed, base64-encoded VersionedTransaction.

There is no getLatestBlockhash, simulateTransaction, getSignatureStatuses, or any read method. Fetch all read data from a separate Solana RPC (your own or a public one).

Submission requirements​

  • Transaction must include a SystemProgram::transfer instruction paying ≥1,000,000 lamports to an Everstake tip account.
  • No preflight checks. Invalid txs are dropped at the validator without an explicit error.
  • Set priority fees on the tx itself if you want them; SWQOS adds priority on top, doesn't replace.

Rate limit​

10 transactions per second per client by default. Higher rates available on Pro/custom tiers.

QUIC endpoints​

To access QUIC endpoints, log in to your Blockspace account, purchase a subscription or activate a trial, and add your QUIC pubkey to the desired location in the dashboard under SWQOS → QUIC pubkeys.

6 locations are available: Frankfurt, Amsterdam, New York, Tokyo, London, Singapore.

Authentication​

QUIC connections are authenticated by a Solana keypair. The pubkey of that keypair must be on the SWQOS allowlist (configurable in the dashboard).

This pubkey is for transport authentication only — it does not need to be a signer on the transactions you submit, and it has no effect on which instructions are included.

Wire shape​

Open a QUIC stream, write the bytes of a signed serialized transaction, close the stream. The transaction itself must include the same tip-transfer instruction as the HTTP path (≥1,000,000 lamports).

Limits​

  • Keep-alive — 10 seconds.
  • Connections per minute — 8 per authorized pubkey.

Tip accounts​

The full list of valid tip recipient pubkeys is published in the open-source SWQOS docs at github.com/everstake/everstake-swqos-docs. The list is rotated occasionally — pull the current list from there.

You can also find the current tip accounts in your Blockspace account on the Pay-as-you-go page.

What SWQOS doesn't do​

  • It doesn't bypass slot leaders. If the leader is non-Everstake, your tx still has to make it there over normal turbine paths.
  • It doesn't guarantee inclusion. It increases probability under congestion.
  • It doesn't replace priority fees. Set them on the tx itself; SWQOS layers on top.
  • It doesn't perform preflight checks. Malformed or under-tipped transactions are silently dropped.