Skip to content
Developers3 min read

OrbitFlare endpoints and region codes

OrbitFlare endpoints are pinned to a region. URL formats and region codes for Solana RPC, WebSocket, Yellowstone gRPC, Jetstream, Apex and devnet.

Julius Schmitt · OrbitFlare
OrbitFlare endpoints and region codes

OrbitFlare endpoints are pinned to a region, so you connect to a named city rather than one global address. Choose the region that’s nearest to the server making the requests. Solana shared RPC is available in 11 regions and uses this URL structure: https://{code}.rpc.orbitflare.com. There is no auto-routed mainnet.rpc.orbitflare.com host, so if you copied one from an old example, replace it with a regional endpoint.

OrbitFlare endpoints: URL formats

URL format for each service

gRPC uses bare http:// because these endpoints speak gRPC over plaintext HTTP/2, without TLS. The hosts for Robinhood Chain can be found in our Robinhood Chain article.

Region codes by city

These vary depending on the product, therefore get them from the column where your product is mentioned.

Region codes differ by product

global is another hostname for Apex which is routed to the closest functioning endpoint within Apex. When you need a fixed host, for example in a firewall rule, use a named region.

Codes that no longer work

Here are some old codes that can be seen within copied code.

  • The tok for Tokyo became jp in RPC.
  • The ash for Ashburn became va.
  • The sgp for RPC became sg. Jetstream and Apex still use sgp for Singapore.
  • There is no mainnet.rpc.orbitflare.com. Always use a region host.

How to choose and check a region

Latency to the closest region matters more than anything else on the request path. If you are not sure which region is nearest, call the health endpoint in two or three regions from the server itself and compare the round-trip times:

curl "https://fra.rpc.orbitflare.com/health?api_key=$ORBITFLARE_LICENSE_KEY"

It returns ok, behind or unknown. A request to a region your license doesn’t cover gives you -32404 IP not whitelisted, even with your authorized key; the regions your license covers are listed on it in the dashboard.

The process for Shredstream is reversed: you get your shreds transferred to your own IP and port from one of 8 orderable regions, which you can find on the Shredstream page. Check Solana RPC locations for the full list of cities and products. The code examples are found in authentication docs.

Frequently asked questions

Does OrbitFlare have a global mainnet RPC URL?
No. There is no auto-routed mainnet.rpc.orbitflare.com host, so Solana RPC requests must use a regional endpoint in the format https://{code}.rpc.orbitflare.com.
Which OrbitFlare region should I use?
Choose the region nearest to the server making the requests. If you are not sure which that is, call the health endpoint in two or three regions from the server itself and compare the round-trip times.
Why do I get -32404 IP not whitelisted with a valid key?
That error is returned when you call a region your license doesn't cover, even with an authorized key. The regions your license covers are listed on it in the dashboard.
Which old OrbitFlare region codes no longer work?
For RPC, tok became jp for Tokyo, ash became va for Ashburn, and sgp became sg for Singapore. Jetstream and Apex still use sgp for Singapore.
Why does Yellowstone gRPC use an http:// URL?
gRPC uses bare http:// because these endpoints speak gRPC over plaintext HTTP/2, without TLS. The format is http://{code}.rpc.orbitflare.com:10000.
What does the global hostname do on Apex?
global is an Apex hostname that routes to the closest functioning Apex endpoint. When you need a fixed host, for example in a firewall rule, use a named region instead.

About the author

Julius Schmitt

OrbitFlare

Thanks for reading.Back to all articles

Code. Build. Stream. Without Limits.

Build something that moves.

Choose your infrastructure. We’ll help you find the right setup.

A useful starting point

Edit the brief, then copy it and open your assistant. Paste it into a new chat to get started.

Official sources included. You choose when to send.