Price Streaming

Streaming is the real-time alternative to repeatedly polling the REST price endpoints. For a single price poll, use Get Current Prices for All Supported Assets or Get Current Price for an Asset.

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/StreamPriceUpdates

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 price updates into a single updates array.

updates

PriceUpdate[]

Array of price updates.

Show PriceUpdate

ticker

string

Stock ticker.

symbol

string

Asset symbol.

stock_price

string

Underlying stock price.

token_price

string

Token price.

timestamp

uint64

Unix timestamp of the price update (in nanoseconds).

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/StreamPriceUpdates

{
  "updates": [
    {
      "ticker": "GOOGL",
      "symbol": "GOOGLon",
      "stock_price": "304.915",
      "token_price": "305.39957516982939159",
      "timestamp": "1773350214478735649"
    },
    {
      "ticker": "AAPL",
      "symbol": "AAPLon",
      "stock_price": "256.2475",
      "token_price": "256.791808070580506978",
      "timestamp": "1773350214476688119"
    }
  ]
}

Home

REST API

Streaming API

References

Authentication

Request

Response

Errors

​Authentication

​Request

​Response

​Errors

Authentication

Request

Response

Errors