# gRPC

> Real-time Yellowstone gRPC streaming with rich filters. The recommended interface for trading bots, indexers, and any high-throughput workload.

Real-time streaming of Solana blockchain data via the standard Yellowstone gRPC interface.

<Tip>
**Running an automated trading strategy?** gRPC is almost certainly what you need - higher throughput, more granular filtering, and lower per-event latency than WebSocket.
</Tip>

## What it's for

Trading bots, market makers, indexers, and analytics systems use gRPC to react to on-chain events with minimal latency.

## When should I use gRPC instead of WebSocket?

| You need... | Use this |
|---|---|
| Real-time streams of on-chain events | **gRPC** (this product) |
| On-demand queries (balances, transaction history) | [RPC](https://supanode.xyz/docs/solana/rpc/overview) |
| Lightweight subscriptions for browser apps | [WebSocket](https://supanode.xyz/docs/solana/websocket/overview) |
| Entire blocks streamed (HFT, MEV) | [gRPC + Full Block Streaming](https://supanode.xyz/docs/solana/grpc/full-block-streaming) |

## Endpoints

| Type | URL |
|---|---|
| TLS | `https://fra.supanode.xyz:10013` |
| Plaintext | `http://fra.supanode.xyz:10010` |

Frankfurt region. Use TLS in production. Plaintext is exposed for low-overhead local testing.

## What's included

- **Standard interface:** [Yellowstone gRPC](https://github.com/rpcpool/yellowstone-grpc) - the open-source streaming standard maintained by Triton One.
- **Subscription types:** accounts, transactions, slots, blocks, blocks_meta, entries.
- **Commitment levels:** processed, confirmed, finalized.
- **IP allowlist auth** - same Bundle whitelist as RPC and WebSocket.
- **Unlimited, unmetered throughput** - no per-MB or per-credit billing on the data your streams deliver, on every gRPC tier.

<Tip>
**Throughput is unlimited and unmetered.** Supanode bills by plan tier, so stream data carries no per-MB or per-GB charge. What scales by plan is your **connection count** and per-stream **filter width** - see [Limits](https://supanode.xyz/docs/solana/grpc/limits).
</Tip>

For the full list of streams and parameters, see [What's available](https://supanode.xyz/docs/solana/grpc/whats-available).

## Pricing

gRPC is included in 4 of the 5 Bundle plans, with connections scaling by tier. Connections are your plan quota; per-stream filter caps are detailed in [Limits](https://supanode.xyz/docs/solana/grpc/limits).

| Plan | gRPC connections | Max accounts watched |
|---|---|---|
| STARTER | not included | — |
| FOCUS | 1 | up to 50 |
| BUILD | 10 | up to 5,000 |
| GROW | 20 | up to 24,000 |
| PROFESSIONAL | 50 | up to 100,000 |

<Note>
**STARTER (\$40/mo) is WebSocket-first** - no gRPC. For gRPC start at FOCUS (\$99/mo).
</Note>

Throughput on every gRPC tier is **unlimited and unmetered**. For full per-stream caps see [Limits](https://supanode.xyz/docs/solana/grpc/limits); for the full plan comparison see [Plans](https://supanode.xyz/docs/solana/pricing/plans).

## Free trial

**48 hours, no card.** Contact [@supanode_tgs](https://t.me/supanode_tgs) on Telegram - tell us you'd like to try gRPC and we'll set up your trial within hours.

## External references

- [geyser.proto (SubscribeRequest definition)](https://github.com/rpcpool/yellowstone-grpc/blob/master/yellowstone-grpc-proto/proto/geyser.proto)

## Next steps

<CardGroup cols={2}>
  <Card title="What's available" icon="list" href="https://supanode.xyz/docs/solana/grpc/whats-available">
    Streams you can subscribe to.
  </Card>
  <Card title="Limits" icon="gauge" href="https://supanode.xyz/docs/solana/grpc/limits">
    Rate limits and connection caps.
  </Card>
  <Card title="Restrictions" icon="ban" href="https://supanode.xyz/docs/solana/grpc/restrictions">
    What's not supported and why.
  </Card>
  <Card title="Examples" icon="code" href="https://supanode.xyz/docs/solana/grpc/examples">
    Copy-paste code in 4 languages.
  </Card>
  <Card title="Full Block Streaming" icon="bolt-lightning" href="https://supanode.xyz/docs/solana/grpc/full-block-streaming">
    Empty-filter mode for HFT and indexers.
  </Card>
</CardGroup>