Skip to main content
Stream live market data instead of polling. Nexus exposes a SockJS + STOMP WebSocket at /ws/market that relays token prices, DEX swaps, and dApp blueprint events. Market-data topics broadcast on a 10 second interval, so a subscriber receives a current snapshot on subscribe and then a push every 10 seconds rather than one message per on-chain event. There are two ways to get WebSocket access:
  1. Included with Enterprise. The Enterprise plan includes WebSocket Unlimited, with no package to buy.
  2. A WebSocket package on Starter, Builder, Growth or Scale. These plans include no streaming on their own; the package sets the connection and message limits, and you grant it to the API keys that stream. Packages are never part of a bundle.
Enterprise includes WebSocket Unlimited. Plan access and per-key packages are managed from your account.

Connecting

  • Endpoint: wss://nexus.gerowallet.io/ws/market (SockJS)
  • Protocol: STOMP
  • Auth: API key via ?access_token=nxs_… query parameter or Authorization: Bearer nxs_… header
Access is checked at connection time. Connections without an allowed package/tier are rejected during the handshake; exceeding your concurrent-connection or monthly-message quota caps or closes the connection.

Topics

Subscribe to these STOMP destinations (server → client): {assetId} is the token unit: the policy ID followed by the hex asset name, exactly as assetId appears in GET /api/market/prices. Prices are quoted in ADA, so ADA itself has no price row and /topic/market/prices/lovelace never sends a frame. Price frames carry the same fields as GET /api/market/prices except logo. Logos are static, so fetch them once from the REST endpoint instead of on every 10 second push. Client → server control:

Example

Each delivered message counts toward your package’s monthly message quota. Subscribe only to the tokens/feeds you need; use /app/market/unsubscribe when you no longer need a per-token stream.