🍋 Yuzu

Dashboard

Getting Started

The Yuzu Platform

Guides

Creating API Keys

Rate Limits

Usage with Apollo React/React Native

Recipes

Build a live-updating stock price badge

Show the latest exchange rates for your product

Streaming API

Subscription and Authorization

Available streams

Message reference

GraphQL API

Introduction to GraphQL

Making GraphQL Requests

Authorization

Pagination

Errors

Schema Reference

Streaming API

Available streams

Yuzu allows you to stream prices and key order book information for a variety of asset types. Below is our reference on constructing stream symbols for use with our websocket or server-sent events API.

Stream symbol format


When you connect to the streaming API, you specify a list of streams to follow. These follow a common format of three values, separated by colons: an asset type, an event type, and a symbol.

<Asset Type>:<EventType>:<Symbol>

S:1S:AAPL = Securities:1-Second Aggregates:Apple Inc

Asset Types:

  1. S Securities
  2. C Crypto
  3. F Forex

Event Types:

  1. T All trades
  2. BBO changes to the Best Bid or Offer (also known as top-of-book or the L1 order book)
  3. 1S 1-Second aggregates: snapshots of the last 1 second of trading activity

Asset Symbol

  1. The symbol of an individual asset (e.g. AAPL or BTC-USD)
  2. * for every asset in the bucket

Subscribing to * can consume an enormous amount of data and for performance reasons, shouldn't be used on most frontend clients.

Check out our message reference to get a sense of the format of each available message type.

Support Matrix


Not every type of stream is supported for every asset type. This table documents which streams you have access to through the streaming API.

Event Type Event Symbol Securities S Crypto C Forex F
Top of book BBO ✅ ✅ ✅
Trades T ✅ ✅ 🚫
1-second aggregates 1S ✅ ✅ 🚫

Try it out

Use this tool to learn how to generate streaming URLs.


Subscription and Authorization

Message reference