Skip to main content

Getting started

1. Create an account and request a plan​

Open the Console and enter your email. The login link also creates your account if you’re new to Landed.

Request a plan from Overview. We’ll email you after review. Once approved, return to the Console, choose USD or HKD, and complete payment through Stripe. Your plan activates after payment is confirmed.

In API keys, enter an optional label and choose Generate new key. Save the key when it appears; it is only shown once. For Enterprise or a manually managed plan, contact sales.

Use a production API key with the endpoints shown below.

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"}'

Invalid keys receive 401; inactive subscriptions receive 403; requests over the rate limit receive 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-connection limit.

Include x-api-key in the WebSocket opening handshake. Use a client that supports custom WebSocket headers; a browser’s native WebSocket API cannot set this header. Keep API keys on your server.

Client libraries​

For HTTP requests with @solana/web3.js, pass the key through httpHeaders:

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();