Skip to main content

Getting started

1. Get your endpoint and API key​

There's no public signup form. Email sales or message @landed888 on Telegram with the region(s) and throughput you expect, and we'll confirm a plan and send you:

  • A regional endpoint URL (e.g. https://hkg.rpc.landed.sarl)
  • An API key

2. Authenticate your requests​

Pass your API key in the x-api-key header on every request:

curl https://hkg.rpc.landed.sarl \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}'

Requests without a valid key, or over your plan's rate limit, receive an HTTP 401 or 429. See Errors for what each one means.

3. Pick a region​

Connect to whichever regional endpoint is closest to your infrastructure. See Regions & endpoints for the full list. If you're not sure which one to use, ask sales; there's no penalty for switching later.

4. Subscribe over WebSocket​

The same endpoint accepts WebSocket connections over wss:// for accountSubscribe, programSubscribe, logsSubscribe, signatureSubscribe, and the other standard Solana subscription methods, subject to your plan's concurrent-subscription limit.

Client libraries​

Landed speaks the standard Solana JSON-RPC protocol, so any existing Solana SDK works against your endpoint, including @solana/web3.js:

import { Connection } from "@solana/web3.js";

const connection = new Connection("https://hkg.rpc.landed.sarl", {
  httpHeaders: { "x-api-key": "YOUR_API_KEY" },
});

const slot = await connection.getSlot();