/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:
- Included with Enterprise. The Enterprise plan includes WebSocket Unlimited, with no package to buy.
- 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 orAuthorization: Bearer nxs_…header
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.