Edge Nodes

​

Which edge node to use

​

What the edge nodes serve

• onEventsCreated
• onTokenEventsCreated
• onBarsUpdated (set quoteToken)
• onTokenBarsUpdated

• Other subscriptions (prices, holders, stats, balances, launchpad events, and so on) are accepted, but they are relayed from the main API. That adds a hop, so they arrive slightly later than on graph.codex.io. Keep them on the main endpoint.
• Confirmed data always comes from the main API. If you subscribe to [Processed, Confirmed] on an edge node, you get the Processed update from the edge node and the Confirmed update from the main API, at most once per stage. Leaving out commitmentLevel means Confirmed, the same as on the main endpoint.
• Queries and mutations are not accepted. Send them to https://graph.codex.io/graphql.
• Preprocessed is not supported. It is deprecated because Processed on an edge node now gives the earliest data. Use Processed instead.

​

Connecting

​

SDK

import { Codex, EventCommitmentLevel } from "@codex-data/sdk";

const sdk = new Codex(process.env.CODEX_API_KEY!);

sdk.subscriptions.onTokenEventsCreated(
  {
    input: {
      tokenAddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      networkId: 1399811149,
    },
    commitmentLevel: [EventCommitmentLevel.Processed],
  },
  {
    next: (result) => console.log(result.data),
    error: console.error,
    complete: () => {},
  },
  { useEdge: true },
);

​

Direct WebSocket

import { createClient } from "graphql-ws";

const client = createClient({
  url: "wss://fra.edge.codex.io/graphql",
  connectionParams: {
    Authorization: apiKey,
  },
});

client.subscribe(
  {
    query: `
      subscription($tokenAddress: String!, $networkId: Int!) {
        onTokenEventsCreated(
          input: { tokenAddress: $tokenAddress, networkId: $networkId }
          commitmentLevel: [Processed]
        ) {
          id
          events {
            eventType
            timestamp
            transactionHash
            maker
          }
        }
      }
    `,
    variables: {
      tokenAddress: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      networkId: 1399811149,
    },
  },
  {
    next: (data) => console.log(data),
    error: (error) => console.error(error),
    complete: () => console.log("complete"),
  },
);

​

Good to know

• Processed data is unconfirmed. A small number of events can be dropped or reorged out before confirmation. Use Confirmed from the main API when you need settled data.
• Billing is the same. Each delivered message costs the same as it would on graph.codex.io and counts against the same plan. Edge connections count toward your account’s connection limit.
• Regional feed errors. If an edge node loses its feed for a network, the affected subscriptions end with an EDGE_NETWORK_UNAVAILABLE error. Other subscriptions on the connection keep running. Resubscribe, or fall back to graph.codex.io until it recovers.
• Token bars. On edge nodes, onTokenBarsUpdated returns the same data for FILTERED and UNFILTERED statsType, and the liquidity value refreshes at most every 30 seconds.
• More networks. More networks and edge nodes will be added over time. Check the changelog for updates.