0block docs

Quick Start

Get an API key, add a tip, pick a region, and submit your first transaction to 0block.

1. Get your API key

There are two ways to get a 0block API key:

  • Dashboard (self-serve). Sign up on the 0block dashboard, then open API Keys and create one. The full key is shown once at creation — copy it immediately. See Dashboard & API Keys for the walkthrough.
  • Discord. Request access in our Discord.

API keys have the form 0b_ followed by 43 URL-safe base64 characters (46 characters total). Only the 0b_ + 8-character prefix is ever shown again, so store the full key somewhere safe — treat it like a password.

2. Include a tip

Every transaction submitted to 0block must include a minimum tip of 0.001 SOL (1,000,000 lamports) to one of the official 0block tip accounts:

7ryAvKtymdDdnSqE6g8ctS7sMcmxDCZbzXoRDWSLzero
6646q6HMnzAE7BUhsWma86SebPm2VC9bW9tsDJsDzero
2ZH2unJ7NaCu3kiXaiJPDwjSjDNudFgqhMetSDJGzero
9yXPwviBkVAEWGEbCVkYhzyN7fsrybfDSYv7SeTXzero
4LFeE3G7eJDHoStjPrga6MyJdbrMG924MAyLTp3Rzero
GHjaNw8Sd8ArWZt2UqoH2rGYtzt2MspUmxcAshFkzero
MbCZkyVkpADL3kqWPf94bWXNgzwNeyjUqUXBZn5zero
AYXWDKX1wWwS6Rcydx2Z6QjS1SZhW69z2pxoEpuRzero
8kR3r5aaenaauC1qFcBVwAtMAP9GAANthrsLToe3zero
24wwbjb4vXDpfGHhH61JsPkRQzSnCFWUeiuQpXkZzero

Add a transfer instruction, preferably as the first instruction in your transaction:

import { SystemProgram, PublicKey } from "@solana/web3.js";

transaction.add(
  SystemProgram.transfer({
    fromPubkey: payer.publicKey,
    toPubkey: new PublicKey("7ryAvKtymdDdnSqE6g8ctS7sMcmxDCZbzXoRDWSLzero"),
    lamports: 1_000_000, // 0.001 SOL
  }),
);

The tip gate is structural — it verifies a qualifying transfer is present, not that it is paid. On Solana, a transaction crafted to revert rolls back its tip while still burning base and priority fees, so presence is never proof of payment.

3. Choose a regional endpoint

Connect to the nearest endpoint for the lowest latency. All regions expose the same routes and route to the nearest available Solana cluster.

RegionEndpoint
🇺🇸 North America (East)https://nyc.0block.io
🇺🇸 North America (Central)https://chi.0block.io
🇺🇸 North America (West)https://las.0block.io
🇳🇱 Netherlandshttps://ams.0block.io
🇬🇧 United Kingdomhttps://lon.0block.io
🇩🇪 Germanyhttps://fra.0block.io
🇸🇬 Singaporehttps://sin.0block.io
🇦🇺 Australiahttps://syd.0block.io

4. Send your first transaction

Submit a base64-encoded, fully signed transaction with curl or any HTTP client. Pass your API key with the X-API-Key header (or the ?api-key= query parameter):

curl -X POST 'https://nyc.0block.io/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: <YOUR_API_KEY>' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "<BASE64_ENCODED_TRANSACTION>",
      { "encoding": "base64", "skipPreflight": true }
    ]
  }'

A success response echoes the upstream JSON-RPC result (the transaction signature). Remember: that is a submission-ack, not confirmation.

Next steps