FalconQ Documentation

High-performance Solana RPC, WebSocket, and gRPC infrastructure for builders who demand speed, reliability, and real-time data.

What FalconQ Offers

Solana RPC

Full JSON-RPC with sub-100ms latency, connection pooling, and automatic retries

WebSocket Streaming

Real-time account, transaction, and slot subscriptions

Yellowstone gRPC

Ultra-low latency streaming with persistent channels and advanced filters

FalconStream

Shred-stage gRPC streaming — 15-100ms faster than standard gRPC for earliest transaction detection

Multi-Region

Frankfurt, New York, and Singapore with automatic failover

Usage Analytics

Dashboard with request metrics, latency tracking, and quota monitoring

Quick Start

Get your API key from the dashboard and make your first request in under 60 seconds.

Step 1: Get your API key

Step 2: Make your first RPC call

curl -X POST https://api.falconq.xyz/v1/rpc \
  -H "Authorization: Bearer fq_rpc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getHealth"
  }'

Step 3: Use with @solana/web3.js

import { Connection } from '@solana/web3.js'

const connection = new Connection(
  'https://api.falconq.xyz/v1/rpc',
  {
    httpHeaders: { Authorization: 'Bearer fq_rpc_live_YOUR_KEY' },
    commitment: 'confirmed',
  }
)

const balance = await connection.getBalance(
  new PublicKey('vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg')
)
console.log('Balance:', balance)

Commitment Levels

Solana nodes use commitment levels to determine how finalized a block is. Choose the right level for your use case:

Level	Description	Use Case
finalized	Confirmed by supermajority, considered final	Maximum safety, balance queries
confirmed	Voted on by supermajority, optimistic confirmation	Transaction processing, trading bots
processed	Most recent block seen by the node	Lowest latency, may be skipped

Default is finalized if no commitment is specified. Use confirmed for the best balance of speed and safety.

Response Structure

All RPC methods return a standard JSON-RPC response:

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "apiVersion": "2.0.15",
      "slot": 341197053
    },
    "value": { ... }
  },
  "id": 1
}

context — Contains the slot at which the result was evaluated
value — The actual result data from the RPC method
id — Matches the request ID for correlating responses

Products

Product	Key Prefix	Protocol	Endpoint
FalconQ RPC	fq_rpc_live_...	HTTP JSON-RPC	api.falconq.xyz
FalconQ WebSocket	fq_rpc_live_...	WebSocket	api.falconq.xyz
FalconQ gRPC	fq_grpc_live_...	gRPC streaming	grpc.falconq.xyz
FalconStream	fq_fs_live_...	Shred-stage gRPC	grpc.falconq.xyz:50051

Explore the Docs

Authentication

Bearer headers, query params, WebSocket, and gRPC metadata auth methods.

RPC Methods

Full Solana JSON-RPC with curl and Web3.js examples for every method.

WebSocket

Real-time subscriptions for accounts, transactions, logs, and slots.

gRPC (Yellowstone)

High-throughput streaming with advanced transaction and account filters.

FalconStream

Shred-stage streaming for earliest transaction detection — 15-100ms faster.

Examples

Real-world recipes for token balances, transaction history, and monitoring.

Rate Limits

Plan limits, method restrictions, and troubleshooting guidance.