Query: pairs

Get active DEX pairs for a specific token

pairs

Retrieve all trading pairs (pools) for a given token across all indexed DEXes. Returns pair addresses, DEX protocol, fee tiers, and creation timestamps.

Signature

graphql
pairs(tokenAddress: String!, limit: Int = 10): [Pair!]!

Arguments

Argument	Type	Default	Description
`tokenAddress`	String	Required	Target token contract address
`limit`	Int	10	Maximum pairs to return

Complexity

Base cost: 2 units

Returns

An array of Pair objects:

Field	Type	Description
`address`	String	The pair/pool contract address
`dex`	String	DEX protocol (e.g. `uniswap_v3`, `aerodrome`)
`token0`	String	First token address in the pair
`token1`	String	Second token address in the pair
`feeTier`	Int	Fee tier in basis points (e.g. 3000 = 0.3%)
`createdAt`	String	ISO timestamp of pair creation

Example

graphql
query GetPairs {
  pairs(tokenAddress: "0x532f27101965dd16442e59d40670faf5ebb142e4", limit: 5) {
    address
    dex
    token0
    token1
    feeTier
    createdAt
  }
}