Skip to main content
Confirmed vs. unconfirmed events: Use the commitmentLevel argument to choose which events you receive.
  • confirmed — receive events only after they’re confirmed on-chain. This is the default if commitmentLevel is not specified.
  • processed — receive events as soon as they’re observed on-chain (unconfirmed; may be reorged out). You must explicitly set commitmentLevel: processed to opt in. Currently available on Solana only.
This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
AddEventsOutput
AddEventsOutput
See AddEventsOutput

​
Arguments

​
address
String
The pair contract address.
​
id
String
The ID of the pair (address:networkId). Required unless you are on an enterprise plan including EventFeed features.
​
commitmentLevel
[EventCommitmentLevel!]
The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed. See EventCommitmentLevel
​
quoteToken
QuoteToken
The token of interest within the pair. Can be token0 or token1. See QuoteToken
​
networkId
Int
The networkId to use when getting all events per network
subscription {
  onEventsCreated(
    id: "BGm1tav58oGcsQJehL9WXBFXF7D27vZsKefj4xJKD5Y:1399811149"
    quoteToken: token0
  ) {
    address
    networkId
    id
    quoteToken
    events {
      eventType
      eventDisplayType
      timestamp
      blockNumber
      transactionHash
      maker
      token0Address
      token1Address
      token0SwapValueUsd
      token1SwapValueUsd
      token0ValueBase
      token1ValueBase
      walletAge
      walletLabels
      labels {
        sandwich {
          label
          sandwichType
          token0DrainedAmount
          token1DrainedAmount
        }
      }
    }
  }
}
Example Response
{
  "data": {
    "onEventsCreated": {
      "address": "BGm1tav58oGcsQJehL9WXBFXF7D27vZsKefj4xJKD5Y",
      "networkId": 1399811149,
      "id": "BGm1tav58oGcsQJehL9WXBFXF7D27vZsKefj4xJKD5Y:1399811149",
      "quoteToken": "token0",
      "events": [
        {
          "eventType": "Swap",
          "eventDisplayType": "Sell",
          "timestamp": 1769560515,
          "blockNumber": 396374007,
          "transactionHash": "4EqnQCBDP9AgyKjQu3B7SzFUP6MRXBQWiLGb3b1yqFQQFieamW9B5u3DsH6Ds7KpCfojjxkw27c2izY3xts1A8zx",
          "maker": "7zujqoQsFic14ncDYhBSVGvDnqc94rE49c1ZJCHvAtiW",
          "token0Address": "So11111111111111111111111111111111111111112",
          "token1Address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "token0SwapValueUsd": "126.529818076092595016837547037910922",
          "token1SwapValueUsd": "0.99969429999999993936190205232353184",
          "token0ValueBase": "1",
          "token1ValueBase": "0.0078957792081491622",
          "walletAge": 14494714,
          "walletLabels": null,
          "labels": {
            "sandwich": null
          }
        }
      ]
    }
  }
}

​
Usage Guidelines

  • Subscribe by id (format pairAddress:networkId) to stream transactions for a specific pair
  • Alternatively, use address + networkId to identify the pair, or just networkId to stream all events on a network
  • Set quoteToken to token0 or token1 to control which token is treated as the base for display
  • eventDisplayType provides a human-readable label (Buy, Sell) relative to the quoteToken
  • Use token0SwapValueUsd / token1SwapValueUsd for the USD value of each side of the swap
  • labels includes MEV detection (e.g., sandwich attacks) for transaction quality assessment
  • walletAge returns the age of the maker wallet in seconds, useful for filtering out new wallets

​
Troubleshooting Tips

eventType is the raw on-chain event (e.g., Swap, Mint, Burn). eventDisplayType is a user-friendly label relative to the quoteToken — for example, a Swap is displayed as Buy or Sell depending on which direction the trade went for the quote token.
Yes. Pass only networkId without an address or id to receive all events across a network. This is high-volume — use it with caution or filter client-side.
labels provides MEV and behavioral detection. The sandwich field indicates whether a transaction is part of a sandwich attack — sandwichType identifies it as frontrun, backrun, or sandwiched, and token0DrainedAmount / token1DrainedAmount show how much value was extracted.
quoteToken determines the perspective of eventDisplayType. For example, in a SOL/USDC pair where SOL is token0, setting quoteToken: token0 means buying SOL shows as Buy and selling SOL shows as Sell.
  • Events: Build a token swap list with filtering, pagination, and real-time updates