Skip to main content
This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
AddEventsByMakerOutput
AddEventsByMakerOutput
See AddEventsByMakerOutput

​
Arguments

​
input
OnEventsCreatedByMakerInput!
required
See OnEventsCreatedByMakerInput
​
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
subscription {
  onEventsCreatedByMaker(
    input: { makerAddress: "J8hVkBNKobntWqLspa3yhXEkvb8vZ9S9NiHgirN9yvV3" }
  ) {
    makerAddress
    events {
      eventType
      eventDisplayType
      timestamp
      blockNumber
      transactionHash
      networkId
      address
      maker
      token0Address
      token1Address
      token0SwapValueUsd
      token1SwapValueUsd
      token0ValueBase
      token1ValueBase
      walletAge
      walletLabels
      labels {
        sandwich {
          label
          sandwichType
          token0DrainedAmount
          token1DrainedAmount
        }
      }
    }
  }
}
Example Response
{
  "data": {
    "onEventsCreatedByMaker": {
      "makerAddress": "J8hVkBNKobntWqLspa3yhXEkvb8vZ9S9NiHgirN9yvV3",
      "events": [
        {
          "eventType": "Swap",
          "eventDisplayType": "Buy",
          "timestamp": 1769622047,
          "blockNumber": 396527811,
          "transactionHash": "c12WGJgSjYABk345TJQmwCFKLAT7224X9tdQVRB75V2s7Nj8hJ1XEEvWJQJRhPBakmdEsSHhmr967xtrNGF3V4a",
          "networkId": 1399811149,
          "address": "51FQwjrvo8J8zXUaKyAznJ5NYpoiTCuqAqCu3HAMB9NZ",
          "maker": "J8hVkBNKobntWqLspa3yhXEkvb8vZ9S9NiHgirN9yvV3",
          "token0Address": "So11111111111111111111111111111111111111112",
          "token1Address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "token0SwapValueUsd": "126.074294911024962403570893805582229",
          "token1SwapValueUsd": "0.999689999999999405153188113680867388",
          "token0ValueBase": "1",
          "token1ValueBase": "0.0079291516542248836",
          "walletAge": 4420687,
          "walletLabels": [
            "BOT_V2"
          ],
          "labels": {
            "sandwich": null
          }
        }
      ]
    }
  }
}

​
Usage Guidelines

  • Subscribe with makerAddress to stream all transactions made by a specific wallet in real-time
  • Events are streamed across all pairs and tokens — not scoped to a single pair or network
  • Each event includes the address (pair address) and networkId so you can identify which pair/network the trade occurred on
  • The Event type is the same as returned by onEventsCreated, including swap values, wallet metadata, and sandwich detection labels
  • Use this to build wallet-following features, copy-trading bots, or real-time alerts for specific traders

​
Troubleshooting Tips

onEventsCreated streams events for a specific pair or all pairs on a network. onEventsCreatedByMaker streams events for a specific wallet across all pairs and networks. Use this when you want to follow a trader’s activity regardless of which tokens they’re trading.
No. This subscription streams all events for the wallet across all networks and pairs. Filter client-side if you only want events for specific tokens or networks using the networkId and token0Address/token1Address fields.
All event types are included: Swap, Mint, Burn, Sync, Collect, CollectProtocol. Most wallet-tracking use cases focus on Swap events — filter by eventType or eventDisplayType (Buy/Sell) as needed.
High-activity wallets (like market makers or bots) may produce many events per second. Consider whether you need all events or can sample/filter client-side. For very high-volume wallets, you may want to batch or throttle your processing.
  • Events: Build a token swap list with filtering, pagination, and real-time updates