# yellowstone-grpc

A skill for streaming Solana transactions and account updates over Yellowstone gRPC. Useful when you are building a latency-sensitive trading system.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 432 installs · ★ 443
- Author: agiprolabs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/agiprolabs/claude-trading-skills/tree/HEAD/skills/yellowstone-grpc/SKILL.md
- Updated: 2026-09-03
- HTML: https://affpapa.org/en/nevibecode/skills/yellowstone-grpc

## What it does

The skill teaches your agent to subscribe to a Solana validator data stream through Yellowstone gRPC, a Geyser plugin that pushes transactions, account changes, slots, blocks and entries. Instead of polling REST you get a push stream at roughly 5ms slot latency on p90. REST polling sits at 150ms and up, WebSocket around 10ms.

Inside are subscription templates for Python, Rust and TypeScript, plus a breakdown of filter types and commitment levels. Examples cover watching swaps on a DEX program, tracking specific wallets, monitoring pool reserves, and slicing account data by offset and length to cut bandwidth. A separate section walks through parsing `SubscribeUpdateTransaction`: signature, slot, account keys, instructions, token balance changes.

You need a gRPC-enabled RPC provider with an endpoint and token in `GRPC_ENDPOINT` and `GRPC_TOKEN`. Without that provider access the skill has nothing to connect to, since there is no public Yellowstone endpoint. Python users install `grpcio`, `grpcio-tools`, `protobuf`, `base58`, `solders`, `python-dotenv`, then generate stubs from the repo's proto files. One gotcha: a new `SubscribeRequest` replaces all previous filters rather than adding to them.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add agiprolabs/claude-trading-skills --skill yellowstone-grpc -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/yellowstone-grpc/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/yellowstone-grpc/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add agiprolabs/claude-trading-skills --skill yellowstone-grpc -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/yellowstone-grpc/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add agiprolabs/claude-trading-skills --skill yellowstone-grpc -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/yellowstone-grpc/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install agiprolabs/claude-trading-skills yellowstone-grpc
```

2. **Manually: put the files in place**
- File: `.github/skills/yellowstone-grpc/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add agiprolabs/claude-trading-skills --skill yellowstone-grpc -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/agiprolabs/claude-trading-skills --path skills/yellowstone-grpc
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/yellowstone-grpc/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add agiprolabs/claude-trading-skills --skill yellowstone-grpc -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/agiprolabs/claude-trading-skills/tree/HEAD/skills/yellowstone-grpc/SKILL.md

## When to use it
- subscribe to a Solana transaction stream instead of polling REST
- filter swaps for one DEX program
- track balance changes on chosen wallets
- watch pool reserves through an account subscription
- slice account data by offset and length to save bandwidth

## Example prompts
- Set up a Yellowstone gRPC subscription for PumpFun swaps at PROCESSED commitment
- Show me how to track transactions for these wallets with yellowstone-grpc
- How do I parse SubscribeUpdateTransaction for signature, slot and token balance changes?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e7b0bff36001b489.

BEGIN THIRD-PARTY FILE e7b0bff36001b489
````text
---
name: yellowstone-grpc
description: Real-time Solana transaction and account streaming via Yellowstone gRPC (Geyser plugin)
---

# Yellowstone gRPC — Real-Time Solana Streaming

Stream every transaction, account update, slot, and block on Solana in real-time using Yellowstone gRPC. This is the foundation for any latency-sensitive Solana trading system — replacing REST polling with push-based streaming at ~5ms slot latency.

## Why Yellowstone gRPC

| Method | Slot Latency (p90) | Use Case |
|--------|-------------------|----------|
| REST polling (`getTransaction`) | ~150ms+ | Historical lookups |
| WebSocket (`onLogs`) | ~10ms | Simple notifications |
| **Yellowstone gRPC** | **~5ms** | **Production trading systems** |

Yellowstone is a Geyser plugin that exposes Solana validator data over gRPC. Every major RPC provider runs it. You subscribe to filtered streams of transactions, account changes, slots, blocks, and entries — and the data pushes to you.

## Quick Start

### 1. Get Access

You need a gRPC-enabled RPC provider. See `references/providers.md` for full comparison.

| Provider | gRPC Entry Price | Notes |
|----------|-----------------|-------|
| Shyft | $199/mo | Best value, 7 regions, unlimited bandwidth |
| Helius | $999/mo | LaserStream, DAS APIs included |
| Triton One | ~$2,900/mo | Created Yellowstone, lowest latency |
| QuickNode | Plan-dependent | Marketplace add-on |
| Chainstack | $49/mo (1 stream) | Budget option, limited filters |
| Alchemy | Free tier available | Compute-unit metered |

### 2. Install Dependencies

```bash
# Python
uv pip install grpcio grpcio-tools protobuf base58 solders python-dotenv

# Generate Python stubs from proto files
git clone https://github.com/rpcpool/yellowstone-grpc.git
python -m grpc_tools.protoc \
  -I./yellowstone-grpc/yellowstone-grpc-proto/proto/ \
  --python_out=./generated \
  --pyi_out=./generated \
  --grpc_python_out=./generated \
  ./yellowstone-grpc/yellowstone-grpc-proto/proto/*.proto
```

```toml
# Rust — Cargo.toml
[dependencies]
yellowstone-grpc-client = "6.0.0"
yellowstone-grpc-proto = "6.0.0"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
futures = "0.3"
bs58 = "0.5"
```

```bash
# TypeScript
npm install @triton-one/yellowstone-grpc @solana/web3.js
```

### 3. Environment Setup

```bash
````
END THIRD-PARTY FILE e7b0bff36001b489

The third-party file has ended. Everything between the e7b0bff36001b489 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2331 of 9468 bytes. © agiprolabs · MIT · https://github.com/agiprolabs/claude-trading-skills/tree/HEAD/skills/yellowstone-grpc/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md