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

# EventsQueryInput

> Input filters for getTokenEvents — pair-keyed event history with optional maker, timestamp, eventType, eventDisplayType, quoteToken, and price filters.

### TypeScript shape

```ts theme={null}
interface EventsQueryInput {
  address: string;
  quoteToken?: QuoteToken | null;
  amountNonLiquidityToken?: NumberFilter | null;
  eventDisplayType?: EventDisplayType[] | null;
  eventType?: EventType | null;
  maker?: string | null;
  networkId: number;
  timestamp?: EventQueryTimestampInput | null;
  priceBaseToken?: NumberFilter | null;
  priceBaseTokenTotal?: NumberFilter | null;
  priceUsd?: NumberFilter | null;
  priceUsdTotal?: NumberFilter | null;
  symbolType?: SymbolType | null;
}
```

<ResponseField name="address" type="String!" required>Pair contract address — or token address when `symbolType: TOKEN` (then resolved to the token's top pool).</ResponseField>
<ResponseField name="networkId" type="Int!" required>Network ID (e.g. `1` Ethereum, `56` BNB Chain, `1399811149` Solana).</ResponseField>
<ResponseField name="symbolType" type="SymbolType">`POOL` (default) or `TOKEN` (top-pool lookup). See [SymbolType](/api-reference/graphql/types/SymbolType).</ResponseField>
<ResponseField name="quoteToken" type="QuoteToken">Side of interest. Rebuilds Swap data so `priceUsd` and `amountNonLiquidityToken` reflect the chosen side, and flips Buy/Sell. See [QuoteToken](/api-reference/graphql/types/QuoteToken).</ResponseField>
<ResponseField name="maker" type="String">Filter to swaps from a specific wallet address (transaction sender). Optional.</ResponseField>
<ResponseField name="eventType" type="EventType">`Swap` (default), `Mint`, `Burn` route to swap data. `PoolBalanceChanged` routes to pool events. `Sync` / `Collect` / `CollectProtocol` / `LiquidityLock` short-circuit empty. See [EventType](/api-reference/graphql/types/EventType).</ResponseField>
<ResponseField name="eventDisplayType" type="[EventDisplayType!]">Allow-list filter, applied post-fetch. See [EventDisplayType](/api-reference/graphql/types/EventDisplayType).</ResponseField>
<ResponseField name="timestamp" type="EventQueryTimestampInput">Time window in Unix seconds. See [EventQueryTimestampInput](/api-reference/graphql/types/EventQueryTimestampInput).</ResponseField>
<ResponseField name="amountNonLiquidityToken" type="NumberFilter">Filter on the (quote-aware) decimal amount. See [NumberFilter](/api-reference/graphql/types/NumberFilter).</ResponseField>
<ResponseField name="priceUsd" type="NumberFilter">Filter on per-unit USD price.</ResponseField>
<ResponseField name="priceUsdTotal" type="NumberFilter">Filter on the swap's total USD value (`amount_usd`).</ResponseField>
<ResponseField name="priceBaseToken" type="NumberFilter">Not yet supported on the historical path — passing this filter returns `BAD_REQUEST`.</ResponseField>
<ResponseField name="priceBaseTokenTotal" type="NumberFilter">Not yet supported — same caveat.</ResponseField>