Streams

Authenticate with your API key as a query parameter when opening the socket.

wss://api.anaxer.com/v1/stream?key=YOUR_KEY

Any WebSocket client works — the TypeScript SDK, a browser WebSocket, or wscat from a terminal. The Quickstart shows a no-code connection test.

After connecting, send a JSON message with a subscribe field set to the channel name. The server acknowledges before events flow:

const ws = new WebSocket("wss://api.anaxer.com/v1/stream?key=YOUR_KEY");

ws.onopen = () => ws.send(JSON.stringify({
  subscribe: "creations",
  filters: { enriched: true, excludeMayhem: true }
}));

ws.onmessage = (msg) => {
  const token = JSON.parse(msg.data);
  console.log(token.symbol, token.socials);
};

{
  "type": "subscribed",
  "channel": "creations"
}

Stop a channel without closing the connection. Send unsubscribe with the channel name:

{
  "unsubscribe": "creations"
}

{
  "type": "unsubscribed",
  "channel": "creations"
}

The server sends an application-level heartbeat every 30 seconds:

{ "type": "ping" }

Reply with a pong within 10 seconds or the connection is closed:

{ "type": "pong" }

This lets you distinguish a dead connection from a quiet channel. The SDKs respond to pings and detect stale connections automatically — including on reconnect with exponential backoff.

If a subscription is rejected — for example, your plan does not include a channel — the server sends an error frame instead of a subscribed ack:

{
  "type": "error",
  "code": "forbidden",
  "channel": "trades",
  "message": "Your plan doesn't include this stream."
}

See Error handling for the full list of codes on both REST and stream responses.

When the server closes the WebSocket, it uses these application close codes:

Every event includes a Solana slot and a unix-ms timestamp. If your connection drops, note the last event you received. After reconnecting, backfill via the REST list equivalent with from / to (and walk next cursors). There is no REST since slot parameter:

curl "https://api.anaxer.com/v1/tokens/EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm/trades?from=1751000000000&source=pump_fun&limit=100" \
  -H "Authorization: Bearer YOUR_KEY"

Use GET /v1/creations, GET /v1/graduations, or GET /v1/tokens/:mint/trades for backfill. Transfers REST backfill ships with that endpoint.

Each WebSocket connection is one stream, subscribed to a single channel. Your plan sets how many concurrent connections you can hold open on any one stream — Free: 1, Starter: 1, Pro: 2. To follow creations and graduations at once, open two connections — one per channel. On Pro, two connections per stream also means you can run separate dev and prod connections side by side.

Use the sources filter to limit events to one or more venues. The same values appear on each event as source. Catalog slugs are the human-readable IDs we use internally; pass the source value on the wire.