Yellowstone Authentication

Every gRPC call must be authenticated by sending your API token as the x-token metadata header.

Get a token

Sign in with your Solana wallet, open Builder → Access, and create a token. You can issue and revoke tokens there at any time.

To try the API before signing up, use the shared demo token raptor-demo-token - it is rate-limited and intended only for testing.

x-token Metadata Header

gRPC carries the token as request metadata, not an HTTP header or a query parameter. The SDKs attach x-token to every call (pass an empty string to omit it); with grpcurl, set it with -H. Connect over TLS to yellowstone.raptor.trade:443 - an https:// URL uses native-root TLS, and http://localhost:... is plaintext.

grpcurl -H "x-token: $RAPTOR_TOKEN" \
  -d '{
    "method": "solana::market::token",
    "params": "{\"mint\":\"So11111111111111111111111111111111111111112\"}"
  }' \
  yellowstone.raptor.trade:443 geyser.Geyser/QueryMethod

Next steps

With authentication set up, see how to query and subscribe in the Yellowstone overview or jump to the SDK reference for Rust and TypeScript.

PreviousOverview NextSDK