OHLCV Markets on Solana - GoldRush API Documentation

GoldRush exposes two OHLCV streams on SOLANA_MAINNET:

ohlcvCandlesForPair - candles for a specific pool address.
ohlcvCandlesForToken - candles aggregated across pools carrying that SPL mint.

Both deliver candles in real time over WebSocket as new swaps land in the pool.

Stream candles for a specific pool

Best for charting one pool.

GraphQL Subscription

subscription {
  ohlcvCandlesForPair(
    chain_name: SOLANA_MAINNET
    pair_addresses: ["58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
  ) {
    pair_address
    timestamp
    open
    high
    low
    close
    volume_usd
  }
}

pair_addresses is an array of base58 pool addresses. You can subscribe to multiple pools on one subscription.

Stream candles for a token (across all pools)

ohlcvCandlesForToken aggregates across pools carrying that mint.

subscription {
  ohlcvCandlesForToken(
    chain_name: SOLANA_MAINNET
    token_addresses: ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"]
    interval: ONE_MINUTE
    timeframe: ONE_HOUR
  ) {
    timestamp
    open
    high
    low
    close
    volume_usd
  }
}

When to use pairs vs tokens

Use case	Stream
Chart a single pool	`ohlcvCandlesForPair` with the pool address
Track arbitrage between two venues for the same pair	`ohlcvCandlesForPair` with both pool addresses
Get the USD price of a token aggregated across pools	`ohlcvCandlesForToken`

Patterns

TradingView chart

Subscribe to ohlcvCandlesForPair at the user’s selected interval; push candles into TradingView’s UDF datafeed adapter. The timestamp / open / high / low / close / volume_usd fields map 1:1 to UDF.

Discovery → chart

Pair this stream with the DEX firehose: when a new pool appears in newPairs, automatically subscribe to its OHLCV. Limit to pools above a liquidity threshold to avoid spam.

Pricing service

Use ohlcvCandlesForToken on 1d candles for an aggregated USD price.

DEX firehose - discover new pools to subscribe to.
OHLCV Pairs Stream reference - full subscription schema.
OHLCV Tokens Stream reference - full subscription schema.

​Stream candles for a specific pool

​Stream candles for a token (across all pools)

​When to use pairs vs tokens

​Patterns

​TradingView chart

​Discovery → chart

​Pricing service

​Related