Skip to main content

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.

This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
AddEventsByMakerOutput
AddEventsByMakerOutput
See AddEventsByMakerOutput

​
Arguments

​
input
OnEventsCreatedByMakerInput!
required
See OnEventsCreatedByMakerInput
​
commitmentLevel
[EventCommitmentLevel!]
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