RPC API Overview

​

Overview

​

Endpoints

​

HTTP JSON-RPC

http://localhost:8899

• Account queries
• Transaction submission
• Block information
• Program account queries

​

WebSocket

ws://localhost:8900

• Account subscriptions
• Signature subscriptions
• Slot notifications
• Program account subscriptions

​

Authentication

1. Use reverse proxies (nginx, HAProxy) for rate limiting
2. Implement API key authentication at the proxy level
3. Restrict access by IP address or network
4. Enable HTTPS/WSS for encrypted communication

​

Request Format

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAccountInfo",
  "params": [
    "<account-pubkey>",
    {
      "encoding": "base64"
    }
  ]
}

​

Required Fields

• jsonrpc: Must be “2.0”
• id: Request identifier (number or string)
• method: RPC method name
• params: Array of method parameters (can be empty)

​

Response Format

​

Success Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "context": {
      "slot": 12345
    },
    "value": { /* method-specific data */ }
  }
}

​

Error Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

​

Common Parameters

​

Commitment Levels

• processed: Query the most recent block (may not be finalized)
• confirmed: Query the most recent confirmed block (~400ms)
• finalized: Query the most recent finalized block (~2 seconds)

{
  "commitment": "confirmed"
}

​

Encoding Options

• base58: Base58 encoding (default, limited to 128 bytes)
• base64: Base64 encoding
• base64+zstd: Base64 with zstd compression
• jsonParsed: Parsed JSON for known program types

{
  "encoding": "base64"
}

​

Data Slicing

{
  "dataSlice": {
    "offset": 0,
    "length": 32
  }
}

​

Rate Limits

• HTTP requests: 100 requests/10 seconds per IP
• WebSocket connections: 10 subscriptions per connection
• getRecentBlockhash: 5 requests/second

​

Configuration

agave-validator \
  --rpc-port 8899 \
  --rpc-bind-address 0.0.0.0 \
  --full-rpc-api \
  --rpc-threads 4 \
  --rpc-max-multiple-accounts 100 \
  --health-check-slot-distance 150

​

Key Options

​

Error Codes

​

Health Check

curl -X POST http://localhost:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getHealth"
  }'

​

Next Steps

• RPC Methods - Complete method reference
• WebSocket API - Real-time subscriptions
• CLI Tools - Using the Solana CLI