OHLC Streaming

The stream emits only live, in-progress candles; it does not backfill history. Candles are bucketed by minute and updated on every tick within the bucket. To load historical OHLC candles, use the REST Get OHLC Data for an Asset endpoint. Both endpoints are intended to be used together to provide a complete picture. The REST endpoint provides historical candles to build the chart while the streaming endpoint keeps the chart up to date in real time.

To generate a typed client for this endpoint, see Protobuf Schema & Code Generation.

Authentication

All requests must include your API key in the x-api-key metadata header.

Request

Endpoint: grpc.gm.ondo.finance:443 RPC: ondo.gm.backend.v1.BackendService/StreamOHLC

symbols

string[]

Asset symbols to subscribe to. If empty, you will receive updates for all assets.

Response

A server stream of messages. Each message batches one or more OHLCUpdate objects into a single updates array. Each update is a partial or closed minute candle for a single symbol, covering both the GM token (primary market) and the underlying stock (underlying market).

updates

OHLCUpdate[]

Array of OHLC updates.

Show OHLCUpdate

primary_market

object

OHLC candle for the GM token, keyed by symbol.

Show primary_market

symbol

string

Asset symbol.

open

string

Opening price for the bucket.

high

string

Highest price for the bucket.

low

string

Lowest price for the bucket.

string

Most recent price for the bucket.

underlying_market

object

OHLC candle for the underlying stock, keyed by ticker.

Show underlying_market

ticker

string

Stock ticker.

open

string

Opening price for the bucket.

high

string

Highest price for the bucket.

low

string

Lowest price for the bucket.

string

Most recent price for the bucket.

is_closed

boolean

Marks the final emission for the bucket (the minute boundary crossed). Subsequent updates with a higher timestamp belong to the next bucket.

timestamp

uint64

Bucket start (minute floor) in nanoseconds since epoch. Stable across all partials and the final closed update for a given bucket.

Errors

Request-level problems terminate the stream with a gRPC status:

InvalidArgument (INVALID_SYMBOL): a malformed symbol (must be at least 3 characters and end with on).
NotFound (ASSET_NOT_FOUND): an unknown asset symbol.
Unauthenticated (MISSING_API_KEY or INVALID_API_KEY): a missing or invalid x-api-key.
ResourceExhausted (RATE_LIMITED): per-account stream rate limits exceeded.

The reason code in parentheses is carried in the gRPC error details. See Error Codes.

grpcurl \
  -H "x-api-key: <YOUR_API_KEY>" \
  -d '{"symbols": ["AAPLon", "GOOGLon"]}' \
  grpc.gm.ondo.finance:443 \
  ondo.gm.backend.v1.BackendService/StreamOHLC

{
  "updates": [
    {
      "primaryMarket": {
        "symbol": "AAPLon",
        "open": "256.791808070580506978",
        "high": "257.013422018348623853",
        "low": "256.500000000000000000",
        "close": "256.901234567890123456"
      },
      "underlyingMarket": {
        "ticker": "AAPL",
        "open": "256.2475",
        "high": "256.47",
        "low": "255.96",
        "close": "256.36"
      },
      "isClosed": false,
      "timestamp": "1773350220000000000"
    },
    {
      "primaryMarket": {
        "symbol": "GOOGLon",
        "open": "305.39957516982939159",
        "high": "305.812345678901234567",
        "low": "304.900000000000000000",
        "close": "305.612345678901234567"
      },
      "underlyingMarket": {
        "ticker": "GOOGL",
        "open": "304.915",
        "high": "305.33",
        "low": "304.51",
        "close": "305.12"
      },
      "isClosed": false,
      "timestamp": "1773350220000000000"
    }
  ]
}

Home

REST API

Streaming API

References

Authentication

Request

Response

Errors

​Authentication

​Request

​Response

​Errors

Authentication

Request

Response

Errors