> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# onEventsCreatedByMaker

> Live-streamed transactions for a maker.

<div data-generated>
  ## GraphQL

  ```
  type Subscription {
    # Requires a Growth or Enterprise plan.
    onEventsCreatedByMaker(
      input: OnEventsCreatedByMakerInput!
      commitmentLevel: [EventCommitmentLevel!]
    ): AddEventsByMakerOutput
  }

  enum EventCommitmentLevel {
    Preprocessed
    Processed
    Confirmed
  }

  enum EventType {
    Burn
    Mint
    Swap
    Sync
    Collect
    CollectProtocol
    PoolBalanceChanged
    LiquidityLock
  }

  type BurnEventData {
    amount0: String
    amount1: String
    amount0Shifted: String
    amount1Shifted: String
    tickLower: String
    tickUpper: String
    type: EventType!
  }

  type MintEventData {
    amount0: String
    amount1: String
    amount0Shifted: String
    amount1Shifted: String
    tickLower: String
    tickUpper: String
    type: EventType!
  }

  type SwapEventData {
    amount0: String
    amount0In: String
    amount0Out: String
    amount1: String
    amount1In: String
    amount1Out: String
    amountNonLiquidityToken: String
    priceBaseToken: String
    priceBaseTokenTotal: String
    priceUsd: String
    priceUsdTotal: String
    tick: String
    type: EventType!
  }

  type PoolBalanceChangedEventData {
    amount0: String
    amount1: String
    amount0Shifted: String
    amount1Shifted: String
    token0: String
    token1: String
    sender: String
    protocolFeeAmount0: String
    protocolFeeAmount1: String
    liquidity0: String
    liquidity1: String
    type: EventType!
  }

  union EventData = BurnEventData | MintEventData | SwapEventData | PoolBalanceChangedEventData

  enum QuoteToken {
    token0
    token1
  }

  enum EventDisplayType {
    Burn
    Mint
    Buy
    Sell
    Sync
    Collect
    CollectProtocol
  }

  enum SandwichLabelForEventType {
    sandwiched
    frontrun
    backrun
  }

  type SandwichLabelForEvent {
    label: String!
    sandwichType: SandwichLabelForEventType!
    token0DrainedAmount: String!
    token1DrainedAmount: String!
  }

  type WashtradeLabelForEvent {
    label: String!
  }

  type LabelsForEvent {
    sandwich: SandwichLabelForEvent
    washtrade: WashtradeLabelForEvent
  }

  type PumpCashbackFeeData {
    type: String!
    cashbackFeeBps: Int!
    cashbackAmountLamports: String!
  }

  type PumpAmmCashbackFeeData {
    type: String!
    cashbackFeeBps: Int!
    cashbackAmountLamports: String!
  }

  union SupplementalFeeData = PumpCashbackFeeData | PumpAmmCashbackFeeData

  type EventFeeData {
    poolFeeRateRaw: String
    poolFeeBps: Float
    poolFeeAmountRaw: String
    dynamicFee: Boolean
    estimatedPoolFee: Boolean
    baseFeeNativeUnit: String
    priorityFeeNativeUnit: String
    gasUsed: String
    builderTipNativeUnit: String
    l1DataFeeNativeUnit: String
    txEventCount: Int
    supplementalFeeData: SupplementalFeeData
  }

  type Event {
    address: String!
    commitmentLevel: EventCommitmentLevel!
    baseTokenPrice: String
    blockHash: String!
    blockNumber: Int!
    data: EventData
    eventType: EventType!
    id: String!
    liquidityToken: String
    logIndex: Int!
    maker: String
    networkId: Int!
    quoteToken: QuoteToken
    timestamp: Int!
    token0Address: String
    token1Address: String
    token0SwapValueUsd: String
    token1SwapValueUsd: String
    token0ValueBase: String
    token1ValueBase: String
    token0PoolValueUsd: String
    token1PoolValueUsd: String
    transactionHash: String!
    transactionIndex: Int!
    supplementalIndex: Int
    eventDisplayType: EventDisplayType
    labels: LabelsForEvent
    feeData: EventFeeData
    walletAge: Int
    walletLabels: [String!]
  }

  type AddEventsByMakerOutput {
    makerAddress: String!
    events: [Event!]!
  }

  input OnEventsCreatedByMakerInput {
    makerAddress: String!
  }
  ```
</div>

### Example

<a href="/explore" target="_blank" rel="noopener noreferrer">Test this query in the Explorer →</a>

```graphql theme={null}
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
        }
      }
    }
  }
}
```

```json Example Response theme={null}
{
  "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

<AccordionGroup>
  <Accordion title="How does this differ from onEventsCreated?">
    `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.
  </Accordion>

  <Accordion title="Can I filter by network or token?">
    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.
  </Accordion>

  <Accordion title="What event types are included?">
    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.
  </Accordion>

  <Accordion title="Is there rate limiting or volume concerns?">
    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.
  </Accordion>
</AccordionGroup>

### Related Recipes

* [Events](/recipes/events): Build a token swap list with filtering, pagination, and real-time updates