Returns transactions for a pair.
Endpoint: getTokenEvents
Method: POST
Arguments
| Name | Type | Description |
|---|---|---|
| cursor | String | The cursor to use for pagination. |
| direction | RankingDirection | The order to receive the token events. Can be |
| limit | Int | The maximum number of transactions to return. |
| query | EventsQueryInput! | The query filters to apply to the results. Required |
| Name | Type | Description |
|---|---|---|
| address | String! | The pair contract address to filter by. If you pass a token address in here, it will instead find the top pair for that token and use that. Required |
| amountNonLiquidityToken | NumberFilter | The amount of |
| eventDisplayType | [EventDisplayType] | The list of event display types to filter by. |
| eventType | EventType | The specific event type to filter by. |
| maker | String | The specific wallet address to filter by. |
| networkId | Int! | The network ID to filter by. Required |
| priceBaseToken | NumberFilter | The price per |
| priceBaseTokenTotal | NumberFilter | The total amount of |
| priceUsd | NumberFilter | The price per |
| priceUsdTotal | NumberFilter | The total amount of |
| quoteToken | QuoteToken | The token of interest. Can be |
| timestamp | EventQueryTimestampInput | The time range to filter by. |
Response
| Name | Type | Description |
|---|---|---|
| address | String! | The contract address of the token's top pair. |
| baseTokenPrice | String | The price of the network's base token. |
| blockHash | String! | The hash of the block where the transaction occurred. |
| blockNumber | Int! | The block number for the transaction. |
| data | EventData | The event-specific data for the transaction. Can be BurnEventData or MintEventData or SwapEventData. |
| eventDisplayType | EventDisplayType | A more specific breakdown of eventType. Splits Swap into Buy or Sell. |
| eventType | EventType! | The type of transaction event. Can be Burn, Mint, Swap, Sync, Collect, or CollectProtocol. |
| id | String! | The ID of the event (address:networkId). For example, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1. |
| labels | LabelsForEvent | Labels attributed to the event. |
| liquidityToken | String | The contract address of the token with higher liquidity in the token's top pair. |
| logIndex | Int! | The index of the log in the block. |
| maker | String | The wallet address that performed the transaction. |
| networkId | Int! | The network ID that the token is deployed on. |
| quoteToken | QuoteToken | The token of interest within the token's top pair. Can be token0 or token1. |
| timestamp | Int! | The unix timestamp for when the transaction occurred. |
| token0PoolValueUsd | String | The updated price of token0 in USD, calculated after the transaction. |
| token0SwapValueUsd | String | The price of token0 paid/received in USD, including any fees. |
| token0ValueBase | String | The price of token0 paid/received in the network's base token, including fees. |
| token1PoolValueUsd | String | The updated price of token1 in USD, calculated after the transaction. |
| token1SwapValueUsd | String | The price of token1 paid/received in USD, including any fees. |
| token1ValueBase | String | The price of token1 paid/received in the network's base token, including fees. |
| transactionHash | String! | The unique hash for the transaction. |
| transactionIndex | Int! | The index of the transaction within the block. |
Reverse the order in which token events are returned using
direction: ASCto find the initial liquidity event. Filtering early events bymakercan help with the detection of scams and price manipulation.
Explore
Ask questions, share what you're working on and request new features 👬👭